È possibile utilizzare la creazione guidata oggetto ATL per aggiungere un oggetto o un controllo al vostro ATL o progetti basata su MFC. Per ogni oggetto COM o controllo, che aggiungere, la procedura guidata genera file CPP e H, nonché un file RGS per supporto basato su script del Registro di sistema.
Se si sta tentando di aggiungere un oggetto COM semplice a un progetto MFC, è necessario aggiungere il supporto ATL al progetto esistente. Per ulteriori informazioni su questa funzionalità, vedere Aggiunta di supporto ATL a un progetto MFC.
&Notanbsp; La creazione guidata oggetto aggiunge l'oggetto il progetto attivo. Se si desidera aggiungere il controllo a un altro progetto sull'area di lavoro, deve innanzitutto renderlo il progetto attivo.
Per aggiungere un oggetto o un controllo utilizzando la creazione guidata oggetto
Con il progetto aperto, selezionare il Nuovo oggetto ATL dal menu Inserisci.
- oppure -
Da ClassView, fare clic sul pulsante destro del mouse sulla cartella a livello di progetto e selezionare il Nuovo oggetto ATL dal menu a comparsa.
La creazione guidata oggetto si apre.
&Notanbsp; Se questo è un progetto MFC a cui non hanno precedentemente aggiunto un oggetto ATL, verrà richiesto di specificare se si desidera aggiungere al progetto il supporto ATL. Facendo clic su Sì apre la creazione guidata oggetto.
La creazione guidata oggetto Visualizza le categorie di oggetti a sinistra e le icone degli oggetti in ogni categoria sulla destra. Scegliete una categoria; la procedura guidata consente di visualizzare le icone degli oggetti in quella categoria.
Oggetti ATL
Oggetto semplice aggiunge un oggetto COM minimal.
Add-in oggetto aggiunge un oggetto COM che estende la shell di Visual C++ con il proprio pulsante della barra degli strumenti e la gestione dell'evento. Questo oggetto offre le stesse funzionalità come quella aggiunta dalla creazione guidata DevStudio Add- dal menu File di Visual C++, scheda di Nuovi progetti.
Internet Explorer oggetto aggiunge un oggetto che supporta le interfacce necessarie da Internet Explorer, ma senza supporto per un'interfaccia utente.
Attiva componente Server aggiunge un oggetto che può essere utilizzato dalla funzionalità di Active Server Pages di Internet Information Server (IIS).
Componente Server di transazione MS include i file di intestazione necessari da Microsoft Transaction Server e definisce l'oggetto come nonaggregatable.
Oggetto Component Registrar aggiunge un oggetto che implementa l'interfaccia IComponentRegistrar . Questo oggetto può essere utilizzato per registrare eventuali oggetti nel vostro server in-process che dichiarano la macro DECLARE_OBJECT_DESCRIPTION . Utilizzando questo oggetto è lecito registrare o annullare la registrazione oggetti individualmente, a differenza di DllRegisterServer e DllUnregisterServer che registrare e annullare la registrazione di tutti gli oggetti nel tuo server. Si può anche ottenere un elenco di oggetti in server e le relative descrizioni con il metodo IComponentRegistrar::GetComponents.
Controlli ATL
Pieno controllo aggiunge un oggetto che supporta le interfacce per tutti i contenitori.
Controllo Lite aggiunge un oggetto che supporta le interfacce necessarie per Internet Explorer, incluso il supporto per un'interfaccia utente.
Pagina delle proprietà aggiunge un oggetto che implementa una pagina delle proprietà.
Controllo composito aggiunge un controllo che può ospitare molti altri controlli.
Controllo HTML aggiunge un controllo con funzionalità DHTML e visualizza una pagina web HTML nella sua interfaccia utente.
Controllo composito Lite aggiunge un controllo composito che può ospitare altri controlli, ma supporta solo le interfacce necessarie da Internet Explorer.
Controllo HTML Lite aggiunge un controllo con funzionalità DHTML e visualizza una pagina web HTML nella sua interfaccia utente, ma supporta solo le interfacce necessarie da Internet Explorer.
ATL varie
Finestra di dialogo aggiunge un oggetto che implementa una finestra di dialogo.
Accesso ai dati
Provider aggiunge codice per supportare modelli provider OLE DB.
Consumer aggiunge codice per supportare modelli consumer OLE DB.
Fare doppio clic il controllo o l'oggetto che si desidera inserire. La creazione guidata oggetto viene visualizzata una finestra di dialogo che mostra le opzioni che si applicano all'oggetto o controllo.
&Notanbsp; A seconda del tipo di oggetto o controllo selezionate, alcune delle pagine e opzioni descritte di seguito potrebbero non essere disponibili.
Nella pagina di nomi , immettere i nomi di classe e i file. Per impostazione predefinita, il nome che viene immesso per nome breve diventa la directory principale per tutti gli altri nomi in questa pagina. È possibile immettere i proprio nome, anziché accettare le impostazioni predefinite.
Classe è il nome della classe che implementa l'oggetto.
Coclasse è il nome della classe che contiene un elenco delle interfacce supportato dall'oggetto component.
L'interfaccia è il nome dell'interfaccia che si crea per l'oggetto. Questa interfaccia contiene i metodi personalizzati. Per la completa di controlli, controlli di Internet Explorer, semplici oggetti, oggetti di Internet Explorer, Add-in oggetti, componenti Server attivi e componenti Microsoft Transaction Server, la procedura guidata crea un'interfaccia con il nome specificato. Per gli oggetti di proprietà di pagina, non viene creata alcuna interfaccia personalizzata e la procedura guidata assegna IUnknown come l'interfaccia dell'oggetto. Gli oggetti della finestra di dialogo non si creano un'interfaccia.
Tipo è una stringa di descrizione per l'oggetto che va nel Registro di sistema.
ProgID è un nome che contenitori possono utilizzare anziché il CLSID dell'oggetto.
Nella pagina di attributi selezionare una filettatura modello, tipo di interfaccia e supporto dell'aggregazione:
Scegliere Le interfacce duali , se si desidera che le interfacce dell'oggetto derivare da IDispatch così come supportare le funzioni personalizzate (vtable ha funzioni di interfaccia personalizzate oltre a metodi IDispatch con associazione tardiva). Ciò consente ai client COM e controller di automazione per accedere a vostro oggetto.
Scegliere Interfacce personalizzate per derivare le interfacce dell'oggetto da IUnknown (vtable ha funzioni di interfaccia personalizzata e non i metodi IDispatch ). Un'interfaccia personalizzata può essere più veloce di un'interfaccia duale, soprattutto attraverso i confini di processo.
Scegliere solo per l'aggregazione, se si desidera che l'oggetto per creare un'istanza solo se esso è da aggregare.
Controllare la casella di controllo Supporto ISupportErrorInfo per avere il tuo oggetto implementare il ISupportErrorInfo interfaccia per la segnalazione degli Errori.
Controllare la casella di controllo Supporto di punti di connessione per aggiungere il supporto per i punti di connessione per l'oggetto. La procedura guidata automaticamente ricaverà classe dell'oggetto da IConnectionPointContainerImpl.
Selezionare la casella di controllo Free Threaded marshalling per creare un oggetto marshalling con modello di threading free per il marshalling di puntatori a interfaccia tra thread nello stesso processo in modo efficiente.
Nella pagina della Miscellanea , scegliere le caratteristiche dell'oggetto.
Scegliere opaco di rendere il controllo completamente opaco, in modo che nessuno del contenitore mostra dietro i limiti del controllo. Questo aiuta il contenitore di disegnare il controllo più rapidamente. Il rettangolo intero controllo passa al metodo OnDraw della classe control. Questa opzione Imposta bit nell' utilizzare il enumerazione VIEWSTATUS.
Scegliere Sfondo in tinta unita per rendere il controllo un colore a tinta unita e non un pattern di sfondo. Questa opzione è significativa solo se l' opaco è opzione è anche selezionati. Questa opzione imposta il bit VIEWSTATUS_SOLIDBKGND nell'enumerazione VIEWSTATUS.
Scegliere invisibile in fase di esecuzione per rendere invisibile il controllo in fase di esecuzione. È possibile utilizzare controlli invisibili per eseguire le operazioni in background, come ad esempio gli eventi a intervalli di tempo di cottura.
Scegliere agisce come pulsante per attivare il controllo di agire come un pulsante, in particolare per visualizzare se stessa come pulsante predefinito basato sulle proprietà di ambiente DisplayAsDefault.
Scegliere agisce come etichetta per consentire il controllo di sostituire l'etichetta nativa del contenitore.
Scegliere Aggiungi controllo sulla base di superclasse una delle classi standard di una finestra. L'elenco a discesa contiene i nomi delle classi finestra definiti da Windows. Quando si sceglie uno di questi, la procedura guidata aggiunge una variabile membro CContainedWindow alla classe del controllo. CContainedWindow:: create saranno superclasse classe finestra specificata.
Scegliere Normalize DC di avere il controllo di creare un contesto di periferica normalizzato quando viene chiamato per attirare a sé. Questo standardizza l'aspetto del controllo, ma è meno efficace.
Scegliere inseribile a includere il controllo nella finestra di dialogo Inserisci oggetto di applicazioni quali Microsoft Word e Microsoft Excel. Il controllo può essere quindi inserito da qualsiasi applicazione che supporta gli oggetti incorporati tramite la finestra di dialogo Inserisci oggetto.
Scegliere Con finestre solo per costringere il controllo ad essere con finestre, anche in contenitori che supportano gli oggetti senza finestre. Se non si seleziona questa opzione, il controllo verrà automaticamente essere prive di finestre in contenitori che supportano gli oggetti senza finestre e automaticamente essere con finestre in contenitori che non supportano gli oggetti senza finestre.
Nella pagina delle Proprietà di Stock , selezionare la proprietà predefinite, che si desidera che l'oggetto di sostenere, come didascalia o il Colore del bordo. È possibile selezionare tutte le proprietà di scorte in una sola volta cliccando il gt; > pulsante.
Nella pagina stringhe , immettere i nomi per l'oggetto page di proprietà.
Si intitola il testo visualizzato nella scheda della pagina delle proprietà.
Doc è una stringa di testo che descrive la pagina. La cornice di proprietà potrebbe usare la descrizione in una punta di linea o strumento di stato. La cornice di proprietà standard attualmente non utilizza questa stringa.
HelpFile è il nome del file della Guida associato. Il nome di file della guida dovrebbe essere il nome semplice senza un percorso. Quando l'utente preme aiuto, il telaio si apre il file della guida nella directory denominata nel valore della chiave HelpDir nelle voci del Registro di sistema della proprietà pagina sotto i relativi CLSID.
Nella pagina Add-in , scegliere le caratteristiche per l'oggetto Add-in.
Fornire Toolbar crea un pulsante della barra degli strumenti in che l'utente può fare clic per eseguire un comando aggiunto dal vostro oggetto Add-.
Nome di comando è il nome del comando aggiunto a Visual C++ da Add-in oggetto. Questo nome comparve nell'elenco nella scheda della Macro file e componenti aggiuntivi dal menu strumenti , opzione Personalizza .
Nome del metodo è il nome del metodo che implementa il comando.
Barra degli strumenti di testo è il testo che si desidera visualizzare sul pulsante che aggiungere alla barra degli strumenti per portare fuori il tuo comando.
Status bar testo è il testo che si desidera visualizzare sulla riga di stato quando viene eseguito il comando.
Le descrizioni comandi testo è il testo che si desidera visualizzare nel messaggio per il pulsante della barra degli strumenti della descrizione comandi quando il puntatore del mouse dell'utente passa sopra il pulsante.
Gli eventi dell'applicazione consente all'oggetto Add-in catturare gli eventi dell'applicazione.
Eventi debugger consente all'oggetto aggiuntivo di intercettare eventi debugger.
Nella pagina ASP , scegliere le caratteristiche per il componente Server attivi.
OnStartPage/OnEndPage, selezionata per impostazione predefinita, aggiunge i metodi OnStartPage e OnEndPage all'oggetto.
Se OnStartPage/OnEndPage è selezionata, è possibile scegliere quali Oggetti intrinseci che si desidera avere disponibile come puntatori membro nella classe dell'oggetto. Per impostazione predefinita, è selezionata ogni oggetto intrinseco.
Nella pagina MTX , scegliere le caratteristiche per il componente Microsoft Transaction Server. Dual e Custom scegliere il tipo di interfaccia implementata e Punti di connessione del supporto aggiunge il supporto per i punti di connessione. Queste opzioni sono le stesse di quelle nella pagina attributi per altri tipi di oggetti. Inoltre, la pagina MTX ha due opzioni uniche:
Supporto IObjectControl consente di accedere a tre metodi IObjectControl : Activate, CanBePooled e Deactivate.
Può essere un pool racconta l'ambiente di runtime Transaction Server che l'oggetto deve essere restituito a un pool di istanza dopo la disattivazione, anziché distrutto. Questa opzione non può essere selezionata se non è selezionata anche l'opzione di Supporto IObjectControl.
