Creazione guidata controllo ATL

Inserisce in un progetto ATL (o un progetto MFC con supporto ATL) un controllo ATL. È possibile usare questa procedura guidata per inserire uno dei tre tipi di controlli:

• Controllo standard

• Controllo composito

• Controllo DHTML

Inoltre, è possibile specificare un controllo minimo, rimuovendo le interfacce dall'elenco Interfacce , che vengono fornite come impostazioni predefinite per i controlli da aprire nella maggior parte dei contenitori. È possibile impostare le interfacce supportate per il controllo nella pagina Interfacce della procedura guidata.

Osservazioni:

Lo script di registrazione prodotto da questa procedura guidata registrerà i relativi componenti COM in HKEY_CURRENT_USER anziché HKEY_LOCAL_MACHINE. Per modificare questo comportamento, impostare l'opzione Registra componente per tutti gli utenti della procedura guidata.

Nomi

Specificare i nomi per l'oggetto, l'interfaccia e le classi da aggiungere al progetto. Ad eccezione del nome breve, tutte le altre caselle possono essere modificate in modo indipendente. Se si modifica il testo per Nome breve, la modifica viene applicata ai nomi di tutte le altre caselle in questa pagina. Se si modifica il nome della coclasse nella sezione COM, la modifica viene riflessa nella casella Tipo, ma il nome dell'interfaccia e ProgID non cambiano. Questo comportamento di denominazione è progettato per rendere tutti i nomi facilmente identificabili durante lo sviluppo del controllo.

Nota

La coclasse è modificabile solo su controlli non con attributi. Se il progetto è con attributi, non è possibile modificare CoClass.

C++

Fornisce informazioni per la classe C++ creata per implementare l'oggetto.

• Nome breve

  Imposta il nome abbreviato per l'oggetto. Il nome specificato determina i nomi della classe e della coclasse , il file (. CPP e . H) nomi, nome dell'interfaccia e nomi di tipo , a meno che non si modifichi singolarmente tali campi.

• Classe

  Imposta il nome della classe che implementa l'oggetto. Questo nome è basato sul nome specificato in Nome breve, preceduto da "C", il prefisso tipico per un nome di classe.

• File con estensione h

  Imposta il nome del file di intestazione per la nuova classe dell'oggetto. Per impostazione predefinita, questo nome è basato sul nome specificato in Nome breve. Fare clic sul pulsante con i puntini di sospensione per salvare il nome file nel percorso desiderato o aggiungere la dichiarazione di classe a un file esistente. Se si seleziona un file esistente, la procedura guidata non la salverà nel percorso selezionato fino a quando non si fa clic su Fine.

  La procedura guidata non sovrascrive i file. Se si seleziona il nome di un file esistente, quando si sceglie Fine, la procedura guidata chiede di specificare se la dichiarazione di classe deve essere aggiunta al contenuto del file. Fare clic su Sì per aggiungere il file. Fare clic su No per tornare alla procedura guidata e specificare un altro nome di file.

• File con estensione cpp

  Imposta il nome del file di implementazione per la nuova classe dell'oggetto. Per impostazione predefinita, questo nome è basato sul nome specificato in Nome breve. Fare clic sul pulsante con i puntini di sospensione per salvare il nome del file nel percorso desiderato. Il file non viene salvato nel percorso selezionato fino a quando non si fa clic su Fine nella procedura guidata.

  La procedura guidata non sovrascrive i file. Se si seleziona il nome di un file esistente, quando si sceglie Fine, la procedura guidata chiede di specificare se l'implementazione di classe deve essere aggiunta al contenuto del file. Fare clic su Sì per aggiungere il file. Fare clic su No per tornare alla procedura guidata e specificare un altro nome di file.

• Con attributi

  Indica se l'oggetto usa attributi. Se si aggiunge un oggetto a un progetto ATL con attributi, questa opzione è selezionata e non può essere modificata. Questo significa che è possibile aggiungere oggetti con attributi solo a un progetto creato con supporto per gli attributi.

  È possibile aggiungere un oggetto con attributi solo a un progetto ATL che usa attributi. Se si seleziona questa opzione per un progetto ATL che non include il supporto per gli attributi, la procedura guidata chiede di specificare se si vuole aggiungere il supporto per gli attributi al progetto.

  Per impostazione predefinita, qualsiasi oggetto aggiunto dopo aver impostato questa opzione viene designato come con attributi (la casella di controllo è selezionata). È possibile deselezionare questa casella per aggiungere un oggetto che non usa attributi.

  Per altre informazioni, vedere Impostazioni applicazione, Creazione guidata progetto ATL e Meccanismi di base degli attributi .

COM

Fornisce informazioni sulla funzionalità COM per l'oggetto.

• CoClass

  Imposta il nome della classe del componente che contiene un elenco delle interfacce supportate dall'oggetto.

  Nota

  Se si crea il progetto utilizzando attributi o se si indica in questa pagina della procedura guidata che il controllo utilizza attributi, non è possibile modificare questa opzione perché ATL non include l'attributo coclasse .

• Interfaccia

  Imposta il nome dell'interfaccia per l'oggetto . Per impostazione predefinita, un nome di interfaccia è preceduto da "I".

• Type

  Imposta la descrizione dell'oggetto che verrà visualizzata nel Registro di sistema.

• ProgID

  Imposta il nome che può essere usato dai contenitori invece del CLSID dell'oggetto. Questo campo non viene popolato automaticamente. Se non si popola manualmente questo campo, il controllo potrebbe non essere disponibile per altri strumenti. Ad esempio, i controlli ActiveX generati senza non ProgID sono disponibili nella finestra di dialogo Inserisci controllo ActiveX. Per altre informazioni sulla finestra di dialogo, vedere Inserire controlli ActiveX.

Vedi anche

Controllo ATL
Aggiunta di funzionalità al controllo composito
Nozioni fondamentali sugli oggetti COM ATL