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à
Implementazione di un'interfaccia