Freigeben über

Hinzufügen einer IDL MFC-Eigenschaft

  • Artikel

Der Assistent zum Hinzufügen von IDL MFC-Eigenschaften fügt eine Eigenschaft zu einer IDL-Schnittstelle (Interface Definition Library) hinzu, die in Ihrem Microsoft Framework Class (MFC)-Projekt definiert ist.

Um diesen Assistenten zu verwenden, müssen Sie sich in einem MFC-Projekt, einem ActiveX-Projekt oder einem ATL-Projekt, das MFC unterstützt, verwenden. Wenn Sie beispielsweise über ein Microsoft ActiveX-Steuerelementprojekt verfügen, können Sie das folgende Verfahren verwenden, um einer IDL-Schnittstelle in der Lösung eine Eigenschaft hinzuzufügen.

Hinzufügen einer IDL MFC-Eigenschaft zu Ihrer Schnittstelle

  1. Wählen Sie im Menü Ansicht die Option Klassenansicht aus.

  2. Klicken Sie im Bereich "Klassenansicht " mit der rechten Maustaste auf den Namen der Schnittstelle, der Sie die Eigenschaft hinzufügen möchten.

    Hinweis

    Sie können Eigenschaften auch zu Disp-Schnittstellen hinzufügen, die im Bibliotheksknoten geschachtelt sind, sofern das Projekt nicht attributiert ist.

  3. Wählen Sie im Kontextmenü "Eigenschaft hinzufügen">aus.

  4. Geben Sie im Assistenten zum Hinzufügen von IDL MFC-Eigenschaften die Informationen zum Erstellen der Eigenschaft an.

  5. Wählen Sie OK aus, um die Eigenschaft hinzuzufügen.

Für MFC-Dispinterfaces:

  • Wenn Sie die Membervariable als Implementierungstyp auswählen, werden eine Methode und eine Variable der Klasse hinzugefügt, die sie implementiert.
  • Wenn Sie die Get/Set-Methoden als Implementierungstyp auswählen, werden der implementierenden Klasse zwei Methoden hinzugefügt.

Benutzeroberflächenelementliste

Im folgenden Abschnitt wird der Assistent zum Hinzufügen von IDL MFC-Eigenschaften beschrieben:

Screenshot der ADD IDL MFC-Eigenschaft mit zwei Parametern: int i und char c. Der Eigenschaftentyp ist OLE_COLOR.

  • Eigenschaftenname

    Legt den Namen der Eigenschaft fest.

    Für MFC-Disp-Schnittstellen, die ActiveX-Steuerelementen zugeordnet sind, können Sie einen eigenen Namen angeben oder einen vordefinierten Eigenschaftennamen aus der Liste auswählen. Wenn Sie einen eigenen Eigenschaftennamen bereitstellen, ist der Implementierungstyp Stock (Vordefiniert) nicht verfügbar.

    Weitere Informationen zu einer Beschreibung der Aktieneigenschaften in der Liste finden Sie unter Aktieneigenschaften.

    Schnittstellentyp Eigenschaftennamensoptionen
    Duale ATL-Schnittstelle, benutzerdefinierte Schnittstelle, lokale benutzerdefinierte Schnittstelle Geben Sie einen Eigenschaftennamen an.
    MFC-Disp-Schnittstelle, Disp-Schnittstelle des MFC-ActiveX-Steuerelements Geben Sie einen Eigenschaftennamen an, oder wählen Sie eine Basiseigenschaft aus der Liste aus.

    Wenn Sie eine Eigenschaft aus der Liste auswählen, wird der entsprechende Wert im Feld Eigenschaftentyp angezeigt. Sie können diesen Typ je nach Auswahl des Implementierungstyps ändern.

  • Eigenschaftentyp

    Legt den Typ der Eigenschaft fest, die Sie hinzufügen.

    Geben Sie bei MFC-Disp-Schnittstellen einen eigenen Typ an, oder wählen Sie einen aus der vordefinierten Liste aus. Wenn Sie eine Bestandsimplementierung einer Eigenschaft bereitstellen, ist der Eigenschaftstyp der Aktientyp und kann nicht geändert werden.

  • Variablenname

    Legt den Namen der Membervariable fest, der die Eigenschaft zugeordnet ist.

    Standardmäßig lautet m_der Variablenname PropertyName. Sie können diesen Namen bearbeiten.

    Dieses Feld ist nur für MFC-dispinterfaces sichtbar und wenn Sie die Membervariable unter dem Implementierungstyp angeben.

  • Benachrichtigungsfunktion

    Legt den Namen der Benachrichtigungsfunktion fest, die aufgerufen wird, wenn die Eigenschaft geändert wird.

    Standardmäßig lautet Onder Name der Benachrichtigungsfunktion PropertyNameChanged. Sie können diesen Namen bearbeiten.

    Dieses Feld ist nur für MFC-dispinterfaces sichtbar und wenn Sie die Membervariable unter dem Implementierungstyp angeben.

  • Get-Funktion

    Legt den Namen der Funktion fest, die die Eigenschaft abrufen soll.

    Der Name der Get-Funktion lautet standardmäßig GetPropertyName. Sie können diesen Namen bearbeiten.

    Wenn Sie den Namen löschen, wird die Funktion GetNotSupported in die Dispatchzuordnung der Schnittstelle eingefügt.

    Dieses Feld ist nur für MFC-dispinterfaces sichtbar und wenn Sie Get/Set-Methoden unter Dem Implementierungstyp angeben.

  • Funktion festlegen

    Legt den Namen der Funktion fest, die die Eigenschaft festlegen soll.

    Der Name der Set-Funktion lautet standardmäßig SetPropertyName. Sie können diesen Namen bearbeiten.

    Wenn Sie den Namen löschen, wird die Funktion SetNotSupported in die Dispatchzuordnung der Schnittstelle eingefügt.

    Dieses Feld ist nur für MFC-dispinterfaces sichtbar und wenn Sie Get/Set-Methoden unter Dem Implementierungstyp angeben.

  • Implementierungstyp

    Gibt an, wie die hinzugefügten Eigenschaften implementiert werden sollen.

    Nur für MFC-Dispinterfaces verfügbar.

    Implementierungstyp Beschreibung
    Stock Gibt eine Standardimplementierung für die im Eigenschaftennamen ausgewählte Eigenschaft an. Weitere Informationen finden Sie unter Basiseigenschaften.
    Wenn Sie Stock (Vordefiniert) angeben, werden Eigenschaftentyp, Parametertyp und Parametername abgeblendet.
    Membervariable Fügt die Eigenschaft als Membervariable hinzu.
    Sie können benutzerdefinierte Eigenschaften und die meisten Basiseigenschaften als Membervariablen hinzufügen.
    Gibt Standardnamen unter Variablenname und Benachrichtigungsfunktion an. Sie können diesen Namen bearbeiten.
    Sie können keine Membervariable für die CaptionEigenschaften hWndoder Text Eigenschaften angeben.
    Get/Set-Methoden Gibt an, dass die Eigenschaft standardmäßig als GetPropertyName - und SetPropertyName-Funktionen hinzugefügt wird. Diese Namen werden unter Get-Funktion und Set-Funktion angezeigt.
    Sie können den standardmäßig festgelegten Eigenschaftentyp ändern, wodurch ein Wert an die Get-Funktion übergeben wird.
    Sie können Parameter für die Funktionen Get und Set angeben.

  • Standardeigenschaft

    Legt die Eigenschaft als Standard für die Schnittstelle fest.

    Eine Schnittstelle kann nur eine Standardeigenschaft aufweisen.

    Sobald Sie die Standardeigenschaft angegeben haben, ist dieses Kontrollkästchen für alle anderen Eigenschaften, die Sie der Schnittstelle hinzufügen, nicht mehr verfügbar. Nur für eine MFC-Dispinterface verfügbar.

  • Parameter

    Zeigt die Parameter der Methode und deren Typen an.

  • +

    Fügt einen Parameter hinzu. Geben Sie unter "Parameter" den Parametertyp und den Namen ein, und wählen Sie "OK" aus. Beispiel: int x

  • x

    Entfernt den ausgewählten Parameter aus der Liste Parameter.

  • Stiftsymbol

    Bearbeitet den ausgewählten Parameter.

  • id

    Legt die numerische ID fest, die die Eigenschaft identifiziert.

    Diese Option ist nicht für Eigenschaften von benutzerdefinierten Schnittstellen verfügbar. Weitere Informationen finden Sie in id der MIDL-Referenz.

  • helpcontext

    Gibt eine Kontext-ID an, die das Anzeigen von Informationen über diese Eigenschaft in der Hilfedatei ermöglicht.

    Weitere Informationen finden Sie in helpcontext der MIDL-Referenz.

  • helpstring

    Gibt eine Zeichenfolge an, die zum Beschreiben des Elements verwendet wird, auf das sie angewendet wird. Standardmäßig ist der Eigenschaftsname propertyangegeben.

    Weitere Informationen finden Sie in helpstring der MIDL-Referenz.

Basiseigenschaften

Wenn Sie einer MFC-dispinterface eine Eigenschaft hinzufügen, können Sie eine der folgenden Aktieneigenschaften aus der Dropdownliste "Eigenschaftsname " auswählen:

Eigenschaftenname Beschreibung
Appearance Ruft einen Wert ab, der die Darstellung des Steuerelements bestimmt, oder legt diesen fest.
Die Eigenschaft Appearance des Steuerelements kann dreidimensionale Anzeigeeffekte anzeigen oder ausblenden. Dies ist eine Lese-/Schreibumgebungseigenschaft.
BackColor Gibt die Ambient-Eigenschaft BackColor des Steuerelements zurück oder legt diese auf eine Palettenfarbe (RGB) oder eine vordefinierte Systemfarbe fest.
Der Wert entspricht standardmäßig der Vordergrundfarbe des Containers des Steuerelements.
Dies ist eine Lese-/Schreibumgebungseigenschaft.
BorderStyle Gibt die Rahmenart eines Steuerelements zurück oder legt diese fest.
Dies ist eine Lese-/Schreibeigenschaft.
Caption Gibt die Caption-Eigenschaft des Steuerelements zurück oder legt diese fest.
Die Beschriftung ist der Titel des Fensters. Caption verfügt nicht über den Implementierungstyp Membervariable.
Enabled Gibt die Enabled-Eigenschaft des Steuerelements zurück oder legt diese fest.
Ein aktiviertes Steuerelement kann auf vom Benutzer generierte Ereignisse reagieren.
Font Gibt die Ambient-Schriftart des Steuerelements zurück oder legt diese fest.
Null wenn das Steuerelement keine Schriftart aufweist.
ForeColor Gibt die Ambient-Eigenschaft ForeColor des Steuerelements zurück oder legt diese fest.
hWnd Gibt die hWnd-Eigenschaft des Steuerelements zurück oder legt diese fest.
Verfügt über keinen Implementierungstyp der Membervariablen .
ReadyState Gibt die ReadyState-Eigenschaft des Steuerelements zurück oder legt diese fest.
Ein Steuerelement kann folgenden Status aufweisen: nicht initialisiert, initialisiert, wird geladen, interaktiv und abgeschlossen.
Weitere Informationen finden Sie unter READYSTATE im Internet SDK.
Text Gibt den Text zurück, der in einem Steuerelement enthalten ist, oder legt diesen fest.
Verfügt über keinen Implementierungstyp der Membervariablen .

Weitere Informationen

Hinzufügen einer Eigenschaft

Hinzufügen einer IDL-Eigenschaft