Condividi tramite


Nomi, Aggiunta guidata proprietà

Utilizzare questa procedura guidata per aggiungere una proprietà a un'interfaccia.

  • Tipo proprietà
    Consente di impostare il tipo della proprietà da aggiungere. Per le interfacce dispatch MFC specificare il tipo desiderato o selezionarlo dall'elenco predefinito. Se si fornisce un'implementazione predefinita di una proprietà, Tipo proprietà verrà impostato sul tipo predefinito e sarà possibile modificarlo.

  • Nome proprietà
    Consente di impostare il nome della proprietà. Per le interfacce dispatch MFC associate ai controlli ActiveX, è possibile fornire il nome desiderato o selezionare un nome di proprietà predefinito dall'apposito elenco. Se si specifica un nome di proprietà personalizzato, il tipo di implementazione Predefinita non sarà disponibile. Per una descrizione delle proprietà indicate nell'elenco, vedere Proprietà predefinite.

    Tipo di interfaccia

    Descrizione

    Interfaccia duale ATL, interfaccia personalizzata e interfaccia personalizzata locale

    Specificare un nome di proprietà

    Interfaccia dispatch MFC, interfaccia dispatch del controllo ActiveX MFC

    Specificare un nome di proprietà o selezionare una proprietà predefinita dall'elenco. Se si seleziona una proprietà dall'elenco, il valore appropriato verrà visualizzato nella casella Tipo proprietà. Sarà possibile modificare questo tipo, a seconda della selezione effettuata nella casella Tipo di implementazione.

  • Tipo restituito
    Solo interfacce ATL. Consente di impostare il tipo restituito per la proprietà. Per le interfacce duali il tipo restituito è sempre HRESULT e la casella non è disponibile. Per le interfacce personalizzate è possibile selezionare un tipo restituito dall'elenco. È comunque consigliato HRESULT, in quanto consente una modalità di restituzione standard degli errori.

  • Nome variabile
    Solo interfacce dispatch MFC. Disponibile solo se si specifica Variabile membro nella casella Tipo di implementazione. Consente di impostare il nome della variabile membro cui è associata la proprietà. Per impostazione predefinita, il nome della variabile è impostato su m_NomeProprietà. È possibile modificare questo nome.

  • Funzione notifica
    Solo interfacce dispatch MFC. Disponibile solo se si specifica Variabile membro nella casella Tipo di implementazione. Consente di impostare il nome della funzione di notifica che viene chiamata se la proprietà subisce modifiche. Per impostazione predefinita il nome della funzione di notifica è impostato su OnNomeProprietàChanged. È possibile modificare questo nome.

  • Funzione Get
    Per le interfacce dispatch MFC. Disponibile solo se si specifica Metodi Get/Set nella casella Tipo di implementazione. Consente di impostare il nome della funzione che consente di visualizzare la proprietà. Per impostazione predefinita il nome della funzione Get è impostato su GetNomeProprietà. È possibile modificare questo nome. Se si elimina il nome, la funzione GetNotSupported verrà inserita nella mappa di invio dell'interfaccia. La funzione GetNomeProprietà specifica che la proprietà è leggibile.

  • Funzione Set
    Solo interfacce dispatch MFC. Disponibile solo se si specifica Metodi Get/Set nella casella Tipo di implementazione. Consente di impostare il nome della funzione che permette di impostare la proprietà. Per impostazione predefinita il nome della funzione Set è impostato su SetNomeProprietà. È possibile modificare questo nome. Se si elimina il nome, la funzione SetNotSupported verrà inserita nella mappa di invio dell'interfaccia. La funzione SetNomeProprietà specifica che la proprietà è modificabile.

  • Tipo di implementazione
    Solo interfacce dispatch MFC. Consente di specificare le modalità di implementazione della proprietà da aggiungere.

    Tipo di implementazione

    Descrizione

    Predefinito

    Specifica un'implementazione predefinita per la proprietà selezionata in Nome proprietà. Impostazione predefinita. Per ulteriori informazioni, vedere Proprietà predefinite.

    Se si specifica Predefinita, le caselle Tipo proprietà, Tipo parametro e Nome parametro saranno inattive.

    Variabile membro

    Specifica che la proprietà viene aggiunta come variabile membro. È possibile aggiungere come variabili membro sia proprietà personalizzate che la maggior parte delle proprietà predefinite. Non è possibile specificare Variabile membro per le proprietà Caption, hWnd e Text.

    Fornisce nomi predefiniti in Nome variabile e Funzione notifica. È possibile modificare questo nome.

    Metodi Get/Set

    Specifica che, per impostazione predefinita, la proprietà viene aggiunta sotto forma di funzioni GetNomeProprietà e SetNomeProprietà. Questi nomi vengono visualizzati in Funzione Get e Funzione Set.

    È possibile modificare il Tipo di proprietà predefinito, che passa un valore per la funzione Get. È possibile specificare parametri per le funzioni Get e Set.

  • Funzione Get
    Per interfacce ATL. Consente di impostare la proprietà come leggibile, creando a tale scopo il metodo Get per il recupero della proprietà dall'oggetto. È necessario selezionare Get, Put o entrambi.

  • Funzione Put
    Solo interfacce ATL. Consente di impostare la proprietà come modificabile, creando a tale scopo il metodo Put per l'impostazione della proprietà dell'oggetto. È necessario selezionare Get, Put o entrambi. Se si seleziona quest'opzione, sarà possibile scegliere una delle due modalità di implementazione del metodo riportate di seguito:

    Opzione

    Descrizione

    PropPut

    La funzione PropPut restituisce una copia dell'oggetto. Si tratta del modo predefinito e più comune di rendere modificabile la proprietà.

    PropPutRef

    La funzione PropPutRef restituisce un riferimento all'oggetto, anziché restituire la copia dell'oggetto stesso. Prendere in considerazione l'utilizzo di questa opzione per oggetti quali strutture o matrici di grandi dimensioni che potrebbero presentare sovraccarichi di inizializzazione.

  • Attributi dei parametri
    Solo interfacce ATL. Consente di specificare se il parametro indicato in Nome parametro presenti l'attributo in, out, entrambi o nessuno dei due.

    Opzione

    Descrizione

    in

    Indica che il parametro viene passato dalla procedura chiamante a quella chiamata.

    out

    Indica che il parametro del puntatore viene restituito dalla procedura chiamata a quella chiamante (dal server al client).

  • Tipo parametro
    Consente di impostare il tipo di dati del parametro. Selezionare il tipo desiderato dall'elenco.

  • Nome parametro
    Consente di impostare il nome del parametro aggiunto per la proprietà, se quest'ultima dispone di parametri. Dopo avere scelto Aggiungi, il nome del parametro verrà visualizzato in Elenco parametri.

  • Elenco parametri
    Consente di visualizzare l'elenco degli attributi da aggiungere alla proprietà. Ciascuna voce dell'elenco riporta il nome, il tipo e gli attributi del parametro. Utilizzare Aggiungi e Rimuovi per aggiornare l'elenco.

  • Aggiungi
    Consente di aggiungere alla casella di riepilogo Elenco parametri il parametro specificato in Nome parametro e Tipo parametro. Fare clic su Aggiungi per aggiungere un parametro all'elenco.

  • Rimuovi
    Consente di rimuovere il parametro selezionato in Elenco parametri.

  • Proprietà predefinita
    Solo interfaccia dispatch MFC. Consente di impostare la proprietà come predefinita per l'interfaccia. A ciascuna interfaccia è possibile associare una sola proprietà predefinita. Quando la proprietà predefinita è già stata specificata, per qualsiasi altra proprietà aggiunta all'interfaccia la casella risulterà non disponibile.

Vedere anche

Attività

Aggiunta di una proprietà

Implementazione di un'interfaccia

Riferimenti

Attributi IDL, Aggiunta guidata proprietà