Aggiungere una proprietà MFC IDL

La procedura guidata Aggiungi proprietà MFC IDL aggiunge una proprietà a un'interfaccia IDL (Interface Definition Library) definita nel progetto MFC (Microsoft Framework Class).

Per usare questa procedura guidata, è necessario trovarsi in un progetto MFC, in un progetto ActiveX o in un progetto ATL che supporta MFC. Ad esempio, se si dispone di un progetto di controllo Microsoft ActiveX, è possibile utilizzare la procedura seguente per aggiungere una proprietà a un'interfaccia IDL nella soluzione.

Aggiungere una proprietà MFC IDL all'interfaccia

1. Scegliere Visualizzazione classi dal menu Visualizza.

2. Nel riquadro Visualizzazione classi fare clic con il pulsante destro del mouse sul nome dell'interfaccia a cui si desidera 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. Scegliere Aggiungi>proprietà dal menu di scelta rapida.

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

5. Selezionare OK per aggiungere la proprietà.

Per le interfacce dispinterfaccia MFC:

• Se si seleziona Variabile membro come tipo di implementazione , un metodo e una variabile vengono aggiunti alla classe che la implementa.
• Se si selezionano i metodi Get/Set come tipo di implementazione, vengono aggiunti due metodi alla classe di implementazione.

Elenco di elementi dell'interfaccia utente

La sezione seguente descrive la procedura guidata Aggiungi proprietà MFC IDL:

• Nome proprietà

  Imposta il nome della proprietà.

  Per le interfacce dispatch MFC associate ai controlli ActiveX, è possibile specificare il nome oppure selezionare un nome di proprietà predefinito dall'elenco predefinito. Se si specifica il nome di proprietà, il tipo di implementazione Predefinito non è disponibile.

  Per altre informazioni su una descrizione delle proprietà azionarie nell'elenco, vedere proprietà azionarie.

  Tipo interfaccia	Opzioni nome proprietà
  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 viene visualizzato nella casella Tipo di proprietà. È possibile modificare questo tipo, a seconda della selezione Tipo di implementazione.

• Tipo di proprietà

  Imposta il tipo di proprietà da aggiungere.

  Per le interfacce dispatch MFC, specificare il tipo o selezionarlo dall'elenco predefinito. Se si specifica un'implementazione stock di una proprietà, il tipo di proprietà è il tipo di titolo e non può essere modificato.

• Nome variabile

  Imposta il nome della variabile membro a cui è associata la proprietà.

  Per impostazione predefinita, il nome della variabile è m_PropertyName. È possibile modificare il nome.

  Questo campo è visibile solo per le interfacce dispinterfaccia MFC e se si specifica Variabile membro in Tipo di implementazione.

• Funzione di notifica

  Imposta il nome dalla funzione di notifica chiamata se la proprietà viene modificata.

  Per impostazione predefinita, il nome della funzione di notifica è OnPropertyNameChanged. È possibile modificare il nome.

  Questo campo è visibile solo per le interfacce dispinterfaccia MFC e se si specifica Variabile membro in Tipo di implementazione.

• Get

  Imposta il nome della funzione per ottenere la proprietà.

  Per impostazione predefinita, il nome della Get funzione è GetPropertyName. È possibile modificare il nome.

  Se si elimina il nome, la funzione GetNotSupported viene inserita nella mappa di invio dell'interfaccia.

  Questo campo è visibile solo per le interfacce dispinterfaccia MFC e se si specificano i metodi Get/Set in Tipo di implementazione.

• Set

  Imposta il nome della funzione per impostare la proprietà.

  Per impostazione predefinita, il nome della Set funzione è SetPropertyName. È possibile modificare il nome.

  Se si elimina il nome, la funzione SetNotSupported viene inserita nella mappa di invio dell'interfaccia.

  Questo campo è visibile solo per le interfacce dispinterfaccia MFC e se si specificano i metodi Get/Set in Tipo di implementazione.

• Tipo di implementazione

  Specifica come implementare la proprietà da aggiungere.

  Disponibile solo per le interfacce dispinterfaccia MFC.

  Tipo di implementazione	Descrizione
  Predefinito	Specifica un'implementazione predefinita per la proprietà selezionata in Nome proprietà. Per altre informazioni, vedere Proprietà predefinite. Se si specifica Predefinito, Tipo di proprietà, Tipo parametro e Nome parametro appaiono disattivate.
  Variabile membro	Aggiunge la proprietà come variabile membro. È possibile aggiungere proprietà personalizzate o la maggior parte delle proprietà predefinite come variabili membro. Specifica i nomi predefiniti in Nome variabile e Funzione di notifica. È possibile modificare il nome. Non è possibile specificare la variabile Member per le Captionproprietà , hWndo Text .
  Metodi Get/Set	Specifica che la proprietà viene aggiunta come Getfunzioni PropertyName e SetPropertyName per impostazione predefinita. Questi nomi sono visualizzati nella funzione Get e 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.

• Proprietà predefinita

  Imposta la proprietà come predefinita per l'interfaccia.

  Un'interfaccia può avere una sola proprietà predefinita.

  Dopo aver specificato la proprietà predefinita, questa casella di controllo non è disponibile per altre proprietà aggiunte all'interfaccia. Disponibile solo per una dispinterface MFC.

• Parametri

  Visualizza i parametri del metodo e i relativi tipi.

• +

  Aggiunge un parametro. In Parametri digitare il tipo di parametro e il nome e scegliere OK. Ad esempio, usare int x

• x

  Rimuove il parametro selezionato dall'elenco Parametri .

• Icona a forma di matita

  Modifica il parametro selezionato.

• id

  Imposta l'ID numerico che identifica la proprietà.

  Questa opzione non è disponibile per le proprietà di interfacce personalizzate. Per altre informazioni, vedere id nella guida di riferimento MIDL.

• helpcontext

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

  Per altre informazioni, vedere helpcontext nella guida di riferimento MIDL.

• helpstring

  Specifica una stringa di caratteri usata per descrivere l'elemento a cui viene applicata. Per impostazione predefinita, si tratta del propertynome della proprietà.

  Per altre informazioni, vedere helpstring nella guida di riferimento MIDL.

Proprietà predefinite

Se si aggiunge una proprietà a una dispinterface MFC, è possibile scegliere una delle proprietà azionarie seguenti dall'elenco a discesa Nome proprietà:

Nome proprietà	Descrizione
Appearance	Restituisce o imposta un valore che determina l'aspetto del controllo. La proprietà Appearance del controllo può includere o omettere effetti di visualizzazione tridimensionale. Questa è una proprietà di lettura/scrittura ambientale.
BackColor	Restituisce o imposta la proprietà ambientale BackColor del controllo su un colore della tavolozza (RGB) o un colore di sistema predefinito. Per impostazione predefinita, il relativo valore corrisponde al colore di sfondo del contenitore del controllo. Questa è una proprietà di lettura/scrittura ambientale.
BorderStyle	Restituisce o imposta lo stile del bordo per un controllo. Questa è una proprietà di lettura/scrittura.
Caption	Restituisce o imposta la proprietà Caption del controllo. La didascalia è il titolo della finestra. Caption non ha alcun tipo di implementazione variabile membro.
Enabled	Restituisce o imposta la proprietà Enabled del controllo. Un controllo abilitato può rispondere agli eventi generati dall'utente.
Font	Restituisce o imposta il tipo di carattere dell'ambiente del controllo. Null se il controllo non ha alcun tipo di carattere.
ForeColor	Restituisce o imposta la proprietà ambientale ForeColor del controllo.
hWnd	Restituisce o imposta la proprietà hWnd del controllo. Nessun tipo di implementazione di variabile membro.
ReadyState	Restituisce o imposta la proprietà ReadyState del controllo. Un controllo può essere non inizializzato, inizializzato, in caricamento, interattivo o completo. Per altre informazioni, vedere READYSTATE in Internet SDK.
Text	Restituisce o imposta il testo contenuto in un controllo. Nessun tipo di implementazione di variabile membro.

Vedi anche

Add, proprietà

Aggiungi IDL, proprietà