Implementare un'interfaccia

Per implementare un'interfaccia, è necessario avere creato un progetto come un'applicazione ATL COM o un'applicazione MFC con supporto ATL. È possibile usare la Creazione guidata progetto ATL per creare un'applicazione ATL o aggiungere un oggetto ATL all'applicazione MFC per implementare il supporto ATL per un'applicazione MFC.

Dopo aver creato il progetto, per implementare un'interfaccia è necessario per prima cosa aggiungere un oggetto ATL. Per un elenco di procedure guidate per l'aggiunta di oggetti al progetto ATL, vedere Aggiunta di oggetti e controlli a un progetto ATL.

Nota

La procedura guidata non supporta le finestre di dialogo ATL, i servizi Web XML che usano ATL, gli oggetti prestazioni né i contatori delle prestazioni.

Se si aggiunge un controllo ATL è possibile specificare se implementare le interfacce predefinite. Le interfacce predefinite sono elencate nella pagina Interfacce della procedura guidata e definite in atlcom.h.

Dopo aver aggiunto l'oggetto o il controllo, è possibile implementare altre interfacce da qualsiasi libreria dei tipi disponibile usando l'Implementazione guidata interfaccia.

Se si aggiunge una nuova interfaccia, è necessario aggiungerla manualmente al file con estensione idl del progetto. Per altre informazioni, vedere Aggiunta di una nuova interfaccia in un progetto ATL.

Per implementare un'interfaccia:

1. In Visualizzazione classi fare clic con il pulsante destro del mouse sul nome della classe per l'oggetto ATL.

2. Scegliere Aggiungi nel menu di scelta rapida e quindi scegliere Implementa interfaccia per visualizzare l'Implementazione guidata interfaccia.

3. Selezionare le interfacce da implementare dalle librerie di tipi appropriate e selezionare Fine.

4. In Visualizzazione classi espandere i nodi Basi e Interfacce per visualizzare l'interfaccia implementata. Quindi espandere il nodo dell'interfaccia per visualizzare le proprietà, i metodi e gli eventi dell'interfaccia disponibili.

   Nota

   È anche possibile usare il visualizzatore oggetti per esaminare i membri dell'interfaccia.

Contenuto della sezione

• Implementare la procedura guidata dell'interfaccia

Implementazione guidata interfaccia

Questa procedura guidata consente di implementare un'interfaccia per un oggetto COM. Nelle librerie COM disponibili con Visual Studio e Windows sono incluse implementazioni di diverse interfacce. L'implementazione dell'interfaccia è associata a un oggetto quando viene creata un'istanza di tale oggetto. L'implementazione rende disponibili anche i servizi offerti dall'oggetto.

Per una descrizione delle interfacce e delle implementazioni, vedere Interfacce e implementazioni dell'interfaccia in Windows SDK.

• Implementa interfaccia da

  Specifica il percorso della libreria dei tipi, da cui viene creata l'interfaccia.

  Opzione	Descrizione
  Progetto	La libreria dei tipi fa parte del progetto.
  Registro	La libreria dei tipi è registrata nel sistema. Le librerie dei tipi registrate sono elencate in Available type libraries (Librerie dei tipi disponibili).
  File	La libreria dei tipi non è necessariamente registrata nel sistema, ma è archiviata in un file. Specificare il percorso del file in Percorso.

• Available type libraries (Librerie dei tipi disponibili)

  Visualizza le librerie dei tipi disponibili contenenti le definizioni delle interfacce che è possibile implementare. Se si sceglie File in Implementa interfaccia da, questa casella non è disponibile per la modifica.

• Posizione

  Visualizza il percorso della libreria dei tipi attualmente selezionata nell'elenco Available type libraries (Librerie dei tipi disponibili). Se è stato selezionato File in Implementa interfaccia da, selezionare il pulsante con i puntini di sospensione per trovare un file contenente la libreria dei tipi da usare.

• Interfacce

  Visualizza le interfacce le cui definizioni sono incluse nella libreria dei tipi attualmente selezionata nella casella Available type libraries (Librerie dei tipi disponibili).

  Nota

  Le interfacce che hanno lo stesso nome di quelle già implementate dall'oggetto selezionato non vengono visualizzate nella casella Interfacce.

  Pulsante di trasferimento	Descrizione
  >	Aggiunge all'elenco Implementa interfacce il nome dell'interfaccia attualmente selezionata nell'elenco Interfacce.
  >>	Aggiunge all'elenco Implementa interfacce tutti i nomi delle interfacce disponibili nell'elenco Interfacce.
  <	Rimuove il nome dell'interfaccia attualmente selezionata dall'elenco Implementa interfacce.
  <<	Rimuove tutti i nomi delle interfacce attualmente inclusi nell'elenco Implementa interfacce.

• Implementa interfacce

  Visualizza i nomi delle interfacce selezionate per l'implementazione nell'oggetto.

  Nota

  Se si include più di un'interfaccia che deriva da IDispatch oppure si prova a implementare un'interfaccia che deriva da un'altra interfaccia già presente nella classe, è necessario evitare l'ambiguità nelle voci COM_MAP. Per altre informazioni, vedere COM_INTERFACE_ENTRY2.