Aggiungere un metodo MFC IDL

La procedura guidata Aggiungi metodo MFC IDL aggiunge un metodo a un'interfaccia IDL (Interface Definition Library) definita nel progetto MFC (Microsoft Framework Class). Se il progetto contiene una classe associata all'interfaccia , la procedura guidata aggiunge anche il metodo alla classe .

Per usare questa procedura guidata, è necessario trovarsi in un progetto MFC, in un progetto ActiveX o in un progetto ATL che supporta MFC. Ad esempio, se si dispone di un progetto di controllo Microsoft ActiveX, è possibile usare la procedura seguente per aggiungere un metodo a un'interfaccia IDL nella soluzione.

Questa procedura guidata è diversa dalla procedura guidata Aggiungi metodo (che aggiunge un metodo a un'interfaccia IDL) nei modi seguenti:

• È specifico per i progetti MFC, ActiveX o ATL che supportano MFC. Per i progetti ATL che non supportano MFC, è disponibile solo la procedura guidata Aggiungi metodo .

• Aggiunge le voci seguenti se nel progetto viene trovata una mappa Dispatch:

  BEGIN_DISPATCH_MAP(CMFCApplication2Doc, CDocument)
      DISP_FUNCTION_ID(CMFCApplication2Doc, "methodName", dispidmethodName, internalName, VT_EMPTY, VTS_NONE)
  END_DISPATCH_MAP()
  

• Genera l'implementazione del metodo associata seguente:

  void CMFCApplication2Doc::internalName()
  {
       AFX_MANAGE_STATE(AfxGetAppModuleState());
       // TODO: Add your dispatch handler code here
  }
  

Aggiungere un metodo a un'interfaccia

1. Scegliere Visualizzazione classi dal menu Visualizza.

2. Nella Visualizzazione classi espandere il nodo di progetto per visualizzare l'interfaccia a cui si vuole aggiungere il metodo.

3. Fare clic con il pulsante destro del mouse sul nome dell'interfaccia.

4. Nel menu di scelta rapida selezionare Aggiungi e quindi Aggiungi metodo.

5. Nella procedura guidata Aggiungi metodo MFC IDL specificare informazioni sul metodo .

6. Selezionare OK per aggiungere il metodo .

Elenco di elementi dell'interfaccia utente

La sezione seguente descrive l'interfaccia utente della procedura guidata Aggiungi metodo MFC IDL:

• Nome metodo

  Impostare il nome per il metodo . Nella tabella seguente vengono descritte le opzioni del nome del metodo a seconda del tipo di interfaccia:

  Tipo di interfaccia	Nome metodo
  Interfaccia duale ATL, interfaccia personalizzata e interfaccia personalizzata locale	Specificare il nome del metodo.
  Interfaccia dispatch MFC	Specificare il nome del metodo o selezionare un nome di metodo suggerito dall'elenco. Se si seleziona un nome dall'elenco, il tipo restituito appropriato viene visualizzato in Tipo restituito e non può essere modificato.
  Interfaccia dispatch del controllo ActiveX MFC	Specificare il proprio nome del metodo o selezionare uno dei metodi azionari: DoClick o Refresh. Per altre informazioni sui metodi azionari, vedere Controlli ActiveX MFC: Aggiunta di metodi azionari.

• Nome interno

  Disponibile solo quando il tipo di metodo è personalizzato. Il nome interno è il nome che verrà usato nella mappa di distribuzione, il file di intestazione (h) e il file di implementazione (con estensione cpp). Per impostazione predefinita, il nome corrisponde a Nome metodo. Viene aggiunto alla dispinterface MFC.

  Se si aggiunge il metodo a una dispinterface del controllo ActiveX MFC o MFC, è possibile modificare il nome del metodo come descritto nella tabella seguente:

  Tipo interfaccia	Nome interno
  Interfaccia duale ATL, interfaccia personalizzata e interfaccia personalizzata locale	Non disponibile.
  Interfaccia dispatch MFC	Impostare il nome del metodo per impostazione predefinita. È possibile modificare il nome interno.
  Interfaccia dispatch del controllo ActiveX MFC	È possibile impostare il nome interno solo per i metodi personalizzati. I metodi predefiniti non usano un nome interno.

• Tipo restituito

  Tipo di dati restituito dal metodo. Il tipo restituito standard per i metodi di interfaccia è HRESULT.

  Se l'interfaccia è un'interfaccia doppia o un'interfaccia personalizzata, è consentito solo il HRESULT tipo restituito.

  È possibile impostare il tipo di dati in base al tipo di interfaccia a cui viene aggiunto il metodo, come descritto nella tabella seguente:

  Tipo di interfaccia	Tipo restituito
  Interfaccia duale	HRESULT. Non modificabile.
  Interfaccia personalizzata	HRESULT. Non modificabile.
  Interfaccia personalizzata locale	Specificare il proprio tipo restituito o selezionare uno dall'elenco.
  Interfaccia dispatch	Specificare il proprio tipo restituito o selezionare uno dall'elenco.
  Interfaccia dispatch del controllo ActiveX MFC	Se si implementa un metodo predefinito, il tipo restituito è impostato sul valore appropriato e non può essere modificato. Se si seleziona un metodo dall'elenco Nome metodo e si seleziona Personalizzato in Seleziona tipo di metodo, selezionare un tipo restituito dall'elenco.

• Tipo di metodo

  Disponibile solo per i controlli ActiveX MFC. Non disponibile se è stato specificato un nome di metodo in Nome metodo anziché selezionare un metodo dall'elenco.

  Se si seleziona uno dei metodi nell'elenco Nome metodo, nell'elenco a discesa Tipo di metodo selezionare l'implementazione Stock o Custom . La selezione del metodo influisce sull'implementazione del tipo restituito e del metodo fornita dalla procedura guidata, come descritto nella tabella seguente:

  Tipo di metodo	Descrizione
  Predefinito	Valore predefinito. Inserisce l'implementazione predefinita del metodo selezionato nell'elenco Nome metodo. Tipo restituito non può essere modificato se si seleziona Predefinito.
  Personalizzazione	Specificare un'implementazione personalizzata per il metodo selezionato in Nome metodo. È possibile specificare il proprio tipo restituito o selezionare uno dall'elenco Tipo restituito.

• Parametri

  Visualizza i parametri, i modificatori e i tipi del metodo. La procedura guidata aggiorna l'elenco Parametri durante l'aggiunta di parametri.

• +

  Aggiungere un parametro. In Parametri digitare il tipo di parametro, il nome e tutti i modificatori. Ad esempio, int xe scegliere OK.

  Se non si specifica un nome di parametro, la procedura guidata ignora le selezioni dei tipi di parametro e, per i progetti ATL, gli attributi dei parametri vengono ignorati.

• x

  Rimuove il parametro selezionato dall'elenco Parametri .

• Icona a forma di matita

  Modificare il parametro selezionato.

• id

  Imposta l'ID numerico che identifica il metodo . Per altre informazioni, vedere id le informazioni di riferimento su MIDL.

• call_as

  Specifica il nome del metodo remoto di cui eseguire il mapping a questo metodo locale. Per altre informazioni, vedere call_as le informazioni di riferimento su MIDL.

• helpcontext

  Specifica un ID contesto che consente all'utente di visualizzare informazioni sul metodo nel file della Guida. Per altre informazioni, vedere helpcontext le informazioni di riferimento su MIDL.

• helpstring

  Specifica un testo che descrive l'elemento associato. Per impostazione predefinita, il nome del metodo. Per altre informazioni, vedere helpstringnel riferimento MIDL.

Vedi anche

Aggiunta guidata metodo
Aggiunta guidata metodo IDL
Procedure guidate e finestre di dialogo MFC