Hinzufügen einer Membervariable

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
• Dialogfeld-Steuerelemente und Variablentypen

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.

  • public
  • protected
  • private

• 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