Aggiunta di un controllo (Esercitazione di ATL, parte 2)

In questo passaggio si aggiunge un controllo al progetto, lo si compila e lo si testa in una pagina Web.

Procedure

Per aggiungere un oggetto a un progetto ATL

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto Polygon.

2. Scegliere Aggiungi dal menu di scelta rapida e fare clic su Nuovo elemento nel sottomenu.

   Verrà visualizzata la finestra di dialogo Aggiungi nuovo elemento. Le diverse categorie di oggetti sono elencate nella struttura ad albero a sinistra.

3. Fare clic sulla cartella ATL .

4. Nell'elenco dei modelli a destra selezionare Controllo ATL. Fare clic su Aggiungi. Verrà aperta la procedura guidata controllo ATL ed è possibile configurare il controllo.

5. Digitare PolyCtl come nome breve e notare che gli altri campi vengono completati automaticamente. Non fare ancora clic su Fine , perché è necessario apportare altre modifiche.

La pagina Nomi della procedura guidata controlloATL contiene i campi seguenti:

Campo	Contenuto
Nome breve	Nome immesso per il controllo.
Classe	Nome della classe C++ creato per implementare il controllo.
File con estensione h	File creato per contenere la definizione della classe C++.
File con estensione cpp	File creato per contenere l'implementazione della classe C++.
CoClass	Nome della classe del componente per questo controllo.
Interfaccia	Nome dell'interfaccia in cui il controllo implementerà i relativi metodi e proprietà personalizzati.
Tipo	Descrizione del controllo.
ProgID	Nome leggibile che può essere usato per cercare il CLSID del controllo.

Nella procedura guidata controllo ATL è necessario modificare diverse impostazioni aggiuntive.

Per abilitare il supporto per informazioni dettagliate sugli errori e punti di connessione

1. Fare clic su Opzioni per aprire la pagina Opzioni .

2. Selezionare la casella di controllo Punti di connessione . Questa opzione crea il supporto per un'interfaccia in uscita nel file IDL.

È anche possibile aggiungere interfacce per estendere la funzionalità del controllo.

Per estendere la funzionalità del controllo

1. Fare clic su Interfacce per aprire la pagina Interfacce .

2. Selezionare IProvideClassInfo2 e fare clic sulla freccia SU per spostarla nell'elenco Supportato .

3. Selezionare ISpecifyPropertyPages e fare clic sulla freccia SU per spostarla nell'elenco Supportato .

È anche possibile rendere il controllo inseriscibile, ovvero è incorporabile in applicazioni che supportano oggetti incorporati, ad esempio Excel o Word.

Per rendere il controllo inseriscibile

1. Fare clic su Aspetto per aprire la pagina Aspetto .

2. Selezionare la casella di controllo Inseriscibile .

Il poligono visualizzato dall'oggetto avrà un colore di riempimento a tinta unita, quindi è necessario aggiungere una Fill Color proprietà stock.

Per aggiungere una proprietà stock Fill Color e creare il controllo

1. Fare clic su Proprietà azioni per aprire la pagina Proprietà magazzino.

2. In Non supportato scorrere verso il basso l'elenco delle possibili proprietà azionarie. Selezionare Fill Color e fare clic sulla freccia SU per spostarla nell'elenco Supportato .

3. Scegliere Fine.

Quando la procedura guidata crea il controllo, vengono eseguite diverse modifiche al codice e aggiunte ai file. Vengono creati i file seguenti:

Documento	Descrizione
PolyCtl.h	Contiene la maggior parte dell'implementazione della classe CPolyCtlC++.
PolyCtl.cpp	Contiene le parti rimanenti di CPolyCtl.
PolyCtl.rgs	File di testo contenente lo script del Registro di sistema utilizzato per registrare il controllo.
PolyCtl.htm	Pagina Web contenente un riferimento al controllo appena creato.

La procedura guidata apporta anche le modifiche di codice seguenti:

• Aggiunge un'istruzione #include ai file di intestazione precompilati per includere i file ATL necessari per supportare i controlli.

• Modifica Polygon.idl per includere i dettagli del nuovo controllo.

• Aggiunge il nuovo controllo alla mappa oggetti in Polygon.cpp.

È ora possibile compilare il controllo per visualizzarlo in azione.

Compilazione e test del controllo

Per compilare e testare il controllo

1. Scegliere Compila poligono dal menu Compila.

   Al termine della compilazione del controllo, fare clic con il pulsante destro del mouse PolyCtl.htm in Esplora soluzioni e selezionare Visualizza nel browser. Viene visualizzata la pagina Web HTML contenente il controllo . Verrà visualizzata una pagina con il titolo "PAGINA di test ATL 8.0 per l'oggetto PolyCtl" e il controllo, il testo PolyCtl.

Nota

Se il controllo non è visibile, è necessario che alcuni browser richiedano regolazioni delle impostazioni per eseguire controlli ActiveX. Vedere la documentazione del browser su come abilitare i controlli ActiveX.

Nota

Al termine di questa esercitazione, se viene visualizzato un messaggio di errore che indica che il file DLL non può essere creato, chiudere il file di PolyCtl.htm e il contenitore Test del controllo ActiveX e compilare di nuovo la soluzione. Se non è ancora possibile creare la DLL, riavviare il computer o disconnettersi se si usa Servizi terminal.

Successivamente, si aggiungerà una proprietà personalizzata al controllo .

Tornare al passaggio 1 | al passaggio 3

Vedi anche

Esercitazione