Aggiungere una proprietà IDL

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

Questa procedura guidata differisce dalla procedura guidata Aggiungi proprietà e aggiungi proprietàMFC IDL nei modi seguenti:

• La procedura guidata Add Property 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. Nel menu Visualizza selezionare Visualizzazione classi.

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 nella 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 .

Aggiungere una procedura guidata per la proprietà IDL

La sezione seguente descrive l'interfaccia utente che si userà 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 doppie, HRESULT è sempre il tipo restituito e selezionare l'opzione non è disponibile. Per le interfacce personalizzate, è possibile selezionare un tipo restituito dall'elenco. HRESULT è comunque consigliato, in quanto fornisce un modo standard per restituire errori.

• Funzione Get

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

• Put

  Per le interfacce ATL, crea il metodo per impostare il Put 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 la proprietà scrivibile.
  propputref	La PropPutRef funzione restituisce un riferimento all'oggetto anziché restituire la copia dell'oggetto stesso. È consigliabile usare propputref l'opzione per gli oggetti, ad esempio struct di grandi dimensioni o matrici, che potrebbero avere un sovraccarico di inizializzazione.

• Parameters

  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 procedura chiamata. out indica che il parametro 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.

• Attributes (Attributi)

1. helpcontext

   Specifica un ID contesto che consente all'utente di visualizzare informazioni sulla proprietà corrente nel file della Guida. Per altre 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 altre informazioni, vedere helpstring.

3. id

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

• Attributi aggiuntivi

Le parole chiave nel linguaggio MIDL (Microsoft Interface Definition Language) sono descritte in dettaglio nel riferimento al linguaggio MIDL.

Opzione	Descrizione
bindable	Indica che la proprietà supporta il data binding. Per altre 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 altre informazioni, vedere defaultcollelem.
displaybind	Indica che la proprietà deve essere visualizzata all'utente come associabile. Per altre informazioni, vedere displaybind.
hidden	Indica che la proprietà esiste ma non deve essere visualizzata in un visualizzatore per utenti. Per altre informazioni, vedere hidden.
immediatebind	Indica che tutte le modifiche apportate alla proprietà di un oggetto associato a dati verranno immediatamente notificate al database. Per altre informazioni, vedere immediatebind.
local	Specifica al compilatore MIDL che la proprietà non è remota. Per altre 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 altre informazioni, vedere nonbrowsable.
requestedit	Indica che la proprietà supporta la notifica OnRequestEdit. Per altre informazioni, vedere requestedit.
restricted	Specifica che la proprietà non può essere chiamata in modo arbitrario. Per altre informazioni, vedere restricted.
source	Indica che un membro della proprietà è un'origine di eventi. Per altre informazioni, vedere source.

Vedere anche

Add, proprietà
Aggiungere la proprietà MFC IDL