Aggiungere una proprietà IDL

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

Questa procedura guidata è diversa dalla procedura guidata Aggiungi proprietà e Aggiungi proprietà MFC IDL nei modi seguenti:

• La procedura guidata Aggiungi proprietà aggiunge una proprietà a un'interfaccia nel progetto.
• La procedura guidata Aggiungi proprietà MFC IDL è specifica per i progetti MFC, ActiveX o ATL che supportano MFC.

Per aggiungere una proprietà IDL

1. Scegliere Visualizzazione classi dal menu Visualizza.

2. Nella Visualizzazione classi fare clic con il pulsante destro del mouse sul nome dell'interfaccia a cui si vuole aggiungere la proprietà.

   Nota

   È anche possibile aggiungere proprietà alle interfacce dispatch che, se il progetto non è attribuito, sono nidificate all'interno del nodo della libreria.

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

4. Dal menu di scelta rapida selezionare Aggiungi>proprietà.

5. Nella procedura guidata Aggiungi proprietà IDL specificare le informazioni per creare la proprietà.

6. Selezionare OK per aggiungere la proprietà.

I Get metodi e Put della proprietà vengono visualizzati come due icone in Visualizzazione classi nell'interfaccia in cui è definita. Fare doppio clic sull'icona per visualizzare la dichiarazione di proprietà nel .idl file.

Per le interfacce ATL, le Get funzioni e Put vengono aggiunte ai .cpp file e .h .

Aggiunta guidata proprietà IDL

La sezione seguente descrive l'interfaccia utente che verrà usata per aggiungere una proprietà IDL:

• Nome proprietà

  Imposta il nome della proprietà.

• Tipo di proprietà

  Tipo di dati della proprietà.

• Tipo restituito

  Per le interfacce ATL, imposta il tipo restituito per la proprietà . Per le interfacce duali, HRESULT è sempre il tipo restituito e l'opzione di selezione non è disponibile. Per le interfacce personalizzate, è possibile selezionare un tipo restituito dall'elenco. HRESULT è comunque consigliato, poiché fornisce un modo standard per restituire gli errori.

• Get

  Per le interfacce ATL, crea il Get metodo per recuperare il valore della proprietà. Selezionare Get, Put o entrambe.

• Put

  Per le interfacce ATL, crea il Put metodo per impostare il valore della proprietà. Selezionare Get, Put o entrambe. Se si seleziona Put function ,è possibile scegliere tra i due modi seguenti per implementare il metodo :

  Opzione	Descrizione
  propput	La PropPut funzione restituisce una copia dell'oggetto . propput è il valore predefinito e il modo più comune per rendere scrivibile la proprietà.
  propputref	La PropPutRef funzione restituisce un riferimento all'oggetto anziché restituire la copia dell'oggetto stesso. È consigliabile usare propputref l'opzione per oggetti, ad esempio struct o matrici di grandi dimensioni, che potrebbero avere un sovraccarico di inizializzazione.

• Parametri

  Visualizza l'elenco dei parametri aggiunti alla proprietà . Ogni voce dell'elenco include il nome del parametro, il tipo di parametro e gli attributi.

  in indica che il parametro viene passato dalla routine chiamante alla routine chiamata. out indica che il parametro del puntatore viene restituito dalla routine chiamata alla routine chiamante (dal server al client).

• +

  Aggiungere un parametro . In Parametri digitare il tipo di parametro e il nome. Ad esempio, int xe selezionare OK.

• x

  Rimuove il parametro selezionato dai parametri.

• Icona a forma di matita

  Modificare il parametro selezionato.

• Attributi

1. helpcontext

   Specifica un ID contesto che consente all'utente di visualizzare informazioni sulla proprietà corrente nel file della Guida. Per ulteriori informazioni, vedere helpcontext.

2. helpstring

   Specifica una stringa di caratteri usata per descrivere l'elemento a cui viene applicata. Per impostazione predefinita, è impostato su propertyNome proprietà. Per ulteriori informazioni, vedere helpstring.

3. id

   Imposta l'identificatore numerico che identifica la proprietà. Questa opzione non è disponibile per le proprietà di interfacce personalizzate. Per ulteriori informazioni, vedere id.

• Attributi aggiuntivi

Le parole chiave nel linguaggio MIDL (Microsoft Interface Definition Language) sono descritte in dettaglio nelle informazioni di riferimento sul linguaggio MIDL.

Opzione	Descrizione
bindable	Indica che la proprietà supporta il data binding. Per ulteriori informazioni, vedere bindable.
defaultbind	Indica la singola proprietà associabile che meglio rappresenta l'oggetto. Per altre informazioni, vedere defaultbind.
defaultcollelem	Indica che la proprietà è una funzione di accesso per un elemento della raccolta predefinita. Per ulteriori informazioni, vedere defaultcollelem.
displaybind	Indica che la proprietà deve essere visualizzata all'utente come associabile. Per ulteriori informazioni, vedere displaybind.
hidden	Indica che la proprietà esiste ma non deve essere visualizzata in un visualizzatore per utenti. Per ulteriori informazioni, vedere hidden.
immediatebind	Indica che tutte le modifiche apportate alla proprietà di un oggetto associato a dati verranno immediatamente notificate al database. Per ulteriori informazioni, vedere immediatebind.
local	Specifica al compilatore MIDL che la proprietà non è remota. Per ulteriori informazioni, vedere local.
nonbrowsable	Assegna un tag a un membro di interfaccia o interfaccia dispatch che non deve essere visualizzato in un visualizzatore di proprietà. Per ulteriori informazioni, vedere nonbrowsable.
requestedit	Indica che la proprietà supporta la notifica OnRequestEdit. Per ulteriori informazioni, vedere requestedit.
restricted	Specifica che la proprietà non può essere chiamata in modo arbitrario. Per ulteriori informazioni, vedere restricted.
source	Indica che un membro della proprietà è un'origine di eventi. Per ulteriori informazioni, vedere source.

Vedere anche

Add, proprietà
Aggiungere la proprietà MFC IDL