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

  • Articolo

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++.
Coclasse Nome della classe del componente per questo controllo.
Interfaccia Nome dell'interfaccia in cui il controllo implementerà i relativi metodi e proprietà personalizzati.
Type 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 Connessione 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:

file Descrizione
Polyctl 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 su PolyCtl.htm in Esplora soluzioni e scegliere 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 dell'esercitazione, se viene visualizzato un messaggio di errore che indica che non è possibile creare il file DLL, chiudere il file PolyCtl.htm e il contenitore Test di 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