Aggiungere una proprietà IDL

  • Articolo

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:

Screenshot dell'aggiunta della proprietà IDL con due parametri: [ in ] int i e [ in ] char c. Il tipo restituito è HRESULT. Il tipo di proprietà è float.

  • 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