Aggiungere un metodo IDL

La procedura guidata Aggiungi metodo IDL aggiunge un metodo a un'interfaccia IDL (Interface Definition Library), ad esempio in un progetto ATL che contiene un file IDL. Questa procedura guidata non è disponibile nei progetti che supportano MFC.

Questa procedura guidata differisce dalla procedura guidata Aggiungi metodo e dalla procedura guidata Aggiungi metodo MFC IDL nei modi seguenti:

• La procedura guidata Aggiungi metodo aggiunge un metodo a un'interfaccia nel progetto e può aggiornare la classe associata all'interfaccia .
• La procedura guidata Aggiungi metodo MFC IDL è specifica per i progetti MFC, ActiveX o ATL che supportano MFC.

Aggiungere un metodo all'interfaccia IDL

1. Scegliere Visualizzazione classi dal menu Visualizza.

2. Nel riquadro Visualizzazione classi espandere il nodo del progetto per visualizzare l'interfaccia IDL (.idl file) a cui si vuole aggiungere il metodo .

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

4. Scegliere Aggiungi>metodo dal menu di scelta rapida.

5. Nella procedura guidata Aggiungi metodo IDL specificare le informazioni per creare il metodo .

6. Selezionare OK per aggiungere il metodo .

Elenco di elementi dell'interfaccia utente

La sezione seguente descrive l'interfaccia della procedura guidata che verrà usata per aggiungere un metodo:

• Nome metodo

  Specificare un nome per il metodo .

• Tipo restituito

  Tipo di dati restituito dal metodo. Il modo standard per restituire i codici di errore dai metodi definiti in un'interfaccia è con un oggetto HRESULT.

  Nella tabella seguente vengono descritti i diversi tipi di interfacce a cui è possibile aggiungere un metodo e il tipo restituito consentito. Per le interfacce duali e personalizzate, il tipo restituito deve essere HRESULT e la procedura guidata non consente di modificarla.

  Tipo di interfaccia	Tipo restituito
  Interfaccia doppia	HRESULT. Non modificabile.
  Interfaccia personalizzata	HRESULT. Non modificabile.
  Interfaccia personalizzata locale	Specificare il proprio tipo restituito o selezionarlo nell'elenco a discesa.
  Dispinterface	Specificare il proprio tipo restituito o selezionarlo nell'elenco a discesa.

• Parametri

  Visualizza i parametri, i modificatori e i tipi del metodo.

• +

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

• x

  Rimuove il parametro selezionato dall'elenco Parametri .

• Dedurre i valori dei parametri in/out dai tipi

  Inserisce l'attributo [in] o [out] in base al tipo del parametro.

• Impostare l'ultimo parametro come valore restituito (retval)

  L'ultimo parametro verrà considerato come valore restituito del metodo.

• Attributi

  Gli attributi seguenti sono descritti anche nel riferimento MIDL.

  • id

    Imposta l'ID numerico che identifica il metodo . Per ulteriori informazioni, vedere id.

  • call_as

    Specifica il nome del metodo remoto di cui eseguire il mapping a questo metodo locale. Per ulteriori informazioni, vedere call_as.

  • helpcontext

    Specifica un ID contesto che consente all'utente di visualizzare informazioni sul metodo nel file della Guida. Per ulteriori informazioni, vedere helpcontext.

  • helpstring

    Specifica la stringa di caratteri utilizzata per descrivere l'elemento a cui si applica. Per ulteriori informazioni, vedere helpstring.

• Attributi aggiuntivi

  • hidden

    Indica che l'elemento esiste ma non deve essere visualizzato in un browser orientato all'utente. Per ulteriori informazioni, vedere hidden.

  • local

    Specifica che un'interfaccia o una funzione non è remota. Per ulteriori informazioni, vedere local.

  • restricted

    Specifica che non è possibile chiamare arbitrariamente una libreria o un membro di un modulo, un'interfaccia o una dispinterface. Per ulteriori informazioni, vedere restricted.

  • source

    Indica che un membro di una proprietà o di un coclassmetodo è un'origine di eventi. Per un membro di , coclassquesto attributo indica che il membro viene chiamato anziché implementato. Per ulteriori informazioni, vedere source.

Vedi anche

Aggiunta guidata metodo
Aggiunta guidata metodo MFC IDL