Hinzufügen einer Membervariable

  • Artikel

Mithilfe der Klassenansicht können Sie einer Klasse eine Membervariable hinzufügen. Membervariablen können generisch sein oder für Datenaustausch und Datenvalidierung verwendet werden. Der Assistent für Datenmembervariablen ist dafür ausgelegt, die relevanten Informationen zu verwenden, um Elemente an den entsprechenden Stellen in Quelldateien einzufügen. Sie können eine Membervariable aus dem Dialog-Editor oder der Klassenansicht der Ressourcenansicht hinzufügen.

Hinweis

Wenn Sie ein Dialogfeld entwerfen und implementieren, kann es sich als effizienter erweisen, den Dialog-Editor zum Hinzufügen der Dialogfeld-Steuerelemente zu verwenden und dann die Membervariablen der Steuerelemente zu implementieren.

So fügen Sie einem Dialogfeld-Steuerelement in der Ressourcenansicht eine Membervariable mithilfe des Assistenten zum Hinzufügen von Membervariablen hinzu:

  1. Erweitern Sie den Projektknoten und den Dialogknoten in der Ressourcenansicht, um die Liste der Dialogfelder des Projekts anzuzeigen.

  2. Doppelklicken Sie auf das Dialogfeld, dem Sie die Membervariable hinzufügen möchten, um es im Dialog-Editor zu öffnen.

  3. Klicken Sie mit der rechten Maustaste auf das Steuerelement im Dialogfeld, das im Dialog-Editor angezeigt wird, das der Membervariable hinzugefügt werden soll.

  4. Klicken Sie im Kontextmenü auf Variable hinzufügen, um den Assistenten zum Hinzufügen von Membervariablen anzuzeigen.

    Hinweis

    In der Steuerelement-ID wird bereits ein Standardwert angegeben.

  5. Geben Sie die Informationen in den entsprechenden Feldern des Assistenten an. Weitere Informationen finden Sie unter Dialog Box Controls and Variable Types (Steuerelemente für Dialogfelder und Variablentypen).

  6. Klicken Sie auf Fertig stellen, um dem Projekt die Definition und den Implementierungscode hinzuzufügen und den Assistenten zu schließen.

So fügen Sie eine Membervariable aus der Klassenansicht mithilfe des Assistenten zum Hinzufügen von Membervariablen hinzu:

  1. Erweitern Sie in der Klassenansicht den Projektknoten, um die Projektklassen anzuzeigen.

  2. Klicken Sie mit der rechten Maustaste auf die Klasse, der eine Variable hinzugefügt werden soll.

  3. Klicken Sie im Kontextmenü auf Hinzufügen und dann auf Variable hinzufügen, um den Assistenten zum Hinzufügen von Membervariablen anzuzeigen.

  4. Geben Sie die Informationen in den entsprechenden Feldern des Assistenten an. Weitere Informationen finden Sie unter Add Member Variable Wizard (Assistent zum Hinzufügen von Membervariablen).

  5. Klicken Sie auf Fertig stellen, um dem Projekt die Definition und den Implementierungscode hinzuzufügen und den Assistenten zu schließen.

In diesem Abschnitt

Assistent zum Hinzufügen von Membervariablen

Dieser Assistent fügt der Headerdatei eine Membervariablendeklaration hinzu. Abhängig von den Optionen können sie der CPP-Datei Code hinzufügen. Sobald Sie eine Membervariable mithilfe des Assistenten hinzugefügt haben, können Sie den Code in der Entwicklungsumgebung bearbeiten.

  • Zugriff

    Legt den Zugriff auf die Membervariable fest. Bei Zugriffsmodifizierern handelt es sich um Schlüsselwörter, die den Zugriff festlegen, den andere Klassen auf die Membervariable haben. Weitere Informationen zum Festlegen des Zugriffs finden Sie unter Member-Access Control (Steuerung des Memberzugriffs). Standardmäßig wird die Zugriffsebene von Membervariablen auf public festgelegt.

  • Variablentyp

    Legt den Rückgabetyp für die hinzugefügte Membervariable fest.

    • Wenn Sie eine Membervariable hinzufügen, bei der es sich nicht um ein Steuerelement für Dialogfelder handelt, wählen Sie den Typ aus der Liste der verfügbaren Typen aus.

      Weitere Informationen zu Typen finden Sie unter Grundlegende Typen.

      • char
      • double
      • float
      • int
      • long
      • short
      • unsigned char
      • unsigned int
      • unsigned long

    • Wenn Sie eine Membervariable für ein Steuerelement für Dialogfelder hinzufügen, wird dieses Feld mit dem Typ des Objekts aufgefüllt, das für ein Steuerelement oder einen Wert zurückgegeben wird. Wenn Sie Steuerelement auswählen, gibt der Variablentyp die Basisklasse des Steuerelements an, das Sie im Feld Steuerelement-ID ausgewählt haben. Wenn das Steuerelement für ein Dialogfeld einen Wert enthalten kann und Sie Wert ausgewählt haben, gibt der Variablentyp den geeigneten Typ für den Wert an, den das Steuerelement enthalten kann. Weitere Informationen finden Sie unter Dialog Box Controls and Variable Types (Steuerelemente für Dialogfelder und Variablentypen).

      Dieser Wert hängt von der Auswahl in Steuerelement-ID ab und kann nicht geändert werden.

  • Variablenname

    Legt den Namen der hinzugefügten Membervariable fest. Membervariablen beginnen üblicherweise mit der Identifizierungszeichenfolge m_, die in der Regel standardmäßig bereitgestellt wird.

  • Steuerelementvariable

    Gibt an, dass die Membervariable ein Steuerelement innerhalb eines Dialogfelds mit Unterstützung für Datenaustausch und Datenvalidierung verwaltet. Weitere Informationen finden Sie unter DoDataExchange (Datenaustausch durchführen). Diese Option ist nur für Membervariablen verfügbar, die zu Klassen hinzugefügt wurden, die von CDialog abgeleitet wurden. Aktivieren Sie dieses Kontrollkästchen, um die Optionen Steuerelement-ID und Steuerelementtyp zu aktivieren.

  • Steuerelement-ID

    Legt die ID für die hinzugefügte Steuerelementvariable fest. Wählen Sie die ID für den Typ des Steuerelements, für den Sie die Membervariable hinzufügen, aus der Liste aus. Diese Liste ist nur aktiv, wenn das Kontrollkästchen Steuerelementvariable aktiviert und auf die Steuerelement-IDs beschränkt ist, die bereits zum Dialogfeld hinzugefügt wurden. Für die Standardschaltfläche OK entspricht die Steuerelement-ID beispielsweise IDOK.

    Option Beschreibung
    Steuerelement Diese Option ist standardmäßig für den Steuerelementtyp festgelegt. Sie verwaltet das Steuerelement, nicht dessen Status oder Inhalte (wie es bei einem Listenfeld, einem Kombinationsfeld oder einem Bearbeitungsfeld möglicherweise gewünscht ist).
    Wert Diese Option ist für Steuerelementtypen verfügbar, die einen Wert enthalten oder einen Status anzeigen können, z.B. ein Eingabefeld oder ein Kontrollkästchen. Sie ist auch verfügbar für Steuerelementtypen, für die Bereich, Inhalt oder Zustand verwaltet werden kann. Weitere Informationen finden Sie unter Dialog Box Controls and Variable Types (Steuerelemente für Dialogfelder und Variablentypen).

  • Kategorie

    Gibt an, ob die Variable auf einem Steuerelementtyp oder auf dem Wert des Steuerelements basiert.

  • Steuerelementtyp

    Legt den Typ des Steuerelements fest, das hinzugefügt wird. Dieses Feld kann nicht geändert werden. Eine Schaltfläche hat beispielsweise den Steuerelementtyp BUTTON, und ein Kombinationsfeld hat den Steuerelementtyp COMBOBOX. Weitere Informationen finden Sie unter Dialog Box Controls and Variable Types (Steuerelemente für Dialogfelder und Variablentypen).

  • Maximale Zeichenanzahl

    Nur verfügbar, wenn der Variablentyp auf CString festgelegt ist. Gibt die maximale Anzahl von Zeichen an, die das Steuerelement enthalten kann.

  • Mindestwert

    Nur verfügbar, wenn der Variablentyp BOOL, int, UINT, long, DWORD, float, double, BYTE, short, , COLECurrency oder CTime ist. Gibt den niedrigsten Wert an, der für eine Skalierung oder einen Datenbereich akzeptiert wird.

  • Höchstwert

    Nur verfügbar, wenn der Variablentyp BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency, oder CTime ist. Gibt den höchsten Wert an, der für eine Skalierung oder einen Datenbereich akzeptiert wird.

  • H-Datei

    Gibt für ActiveX-Steuerelemente an, welche Membervariablen einer Wrapperklasse erfordern. Legt den Namen der Headerdatei fest, die zur Klassendeklaration hinzugefügt werden soll.

  • CPP-Datei

    Gibt für ActiveX-Steuerelemente an, welche Membervariablen einer Wrapperklasse erfordern. Legt den Namen der Implementierungsdatei fest, die zur Klassendefinition hinzugefügt werden soll.

  • Kommentar

    Fügt einen Kommentar zur Headerdatei der Membervariable hinzu.

Dialogfeld-Steuerelemente und Variablentypen

Sie können den Assistenten zum Hinzufügen von Membervariablen verwenden, um einem mit MFC erstellten Dialogfeld-Steuerelement eine Membervariable hinzuzufügen. Der Typ des Steuerelements, dem Sie die Membervariable hinzufügen, bestimmt die Optionen, die im Dialogfeld angezeigt werden.

In der folgenden Tabelle werden alle Steuerelementtypen der Dialogfelder beschrieben, die in MFC und dem Dialog-Editor unterstützt werden. Außerdem werden die verfügbaren Typen und Werte angezeigt.

Steuerelement Steuerelementtyp Variable für den Steuerelementtyp Variable für den Werttyp Min/Max-Werte (nur der Werttyp)
Animationssteuerelement SysAnimate32 CAnimateCtrl Keiner, nur Steuerelement Nicht zutreffend
Schaltfläche SCHALTFLÄCHE CButton Keiner, nur Steuerelement Nicht zutreffend
Kontrollkästchen KONTROLLKÄSTCHEN CButton BOOL Minimalwert/Maximalwert
Kombinationsfeld KOMBINATIONSFELD CComboBox CString Maximale Zeichenanzahl
Datums-/Zeitauswahl-Steuerelement SysDateTimePick32 CDateTimeCtrl CTime Minimalwert/Maximalwert
Bearbeitungsfeld BEARBEITEN CEdit CString, int, UINT, long, DWORD, float, double, BYTE, short, BOOL, COleDateTime oder COleCurrency Minimalwert/Maximalwert, einige unterstützen die maximale Zeichenanzahl
Hotkey-Steuerelement msctls_hotkey32 CHotKeyCtrl Keiner, nur Steuerelement Nicht zutreffend
Listenfeld LISTENFELD CListBox CString Maximale Zeichenanzahl
Listensteuerelement SysListView32 CListCtrl Keiner, nur Steuerelement Nicht zutreffend
Monatskalender-Steuerelement SysMonthCal32 CMonthCalCtrl CTime Minimalwert/Maximalwert
Statuskontrolle msctls_progress32 CProgressCtrl Keiner, nur Steuerelement Nicht zutreffend
Rich Edit 2-Steuerelement RichEdit20A CRichEditCtrl CString Maximale Zeichenanzahl
Rich Edit-Steuerelement RICHEDIT CRichEditCtrl CString Maximale Zeichenanzahl
Scrollleiste (vertikal oder horizontal) SCROLLLEISTE CScrollBar int Minimalwert/Maximalwert
Schieberegler-Steuerelement msctls_trackbar32 CSliderCtrl int Minimalwert/Maximalwert
Drehfeld-Steuerelement msctls_updown32 CSpinButtonCtrl Keiner, nur Steuerelement Nicht zutreffend
Registersteuerelement SysTabControl32 CTabCtrl Keiner, nur Steuerelement Nicht zutreffend
Baumsteuerelement SysTreeView32 CTreeCtrl Keiner, nur Steuerelement Nicht zutreffend