Value-Eigenschaft

Gibt den aktuellen Status eines Steuerelements an. Diese Eigenschaft ist zur Entwurfs- und zur Laufzeit verfügbar.

[Form.]Control.Value[ = nSetting]

Eigenschaftswerte

• nSetting
  Für ein Kontrollkästchen-Steuerelement (CheckBox) sind folgende Einstellungen der Value-Eigenschaft möglich:

  Einstellung	Beschreibung
  0	(Standardeinstellung) Deaktiviert.
  1	Aktiviert.
  2	Abgeblendet (Nullwert). Diese Einstellung steht nur im Code zur Verfügung.

  Für Schaltflächengruppen-Steuerelemente (CommandGroup), Kombinationsfeld-Steuerelemente (ComboBox), Bearbeitungsfeld-Steuerelemente (EditBox), Listenfeld-Steuerelemente (ListBox), Optionsgruppen-Steuerelemente (OptionGroup) und Drehfeld-Steuerelemente (Spinner) ist die Einstellung der Value-Eigenschaft die gewählte Zeichenfolge oder der gewählte numerische Wert.

  Für ein Optionsfeld-Steuerelement (OptionButton) sind folgende Einstellungen der Value-Eigenschaft möglich:

  Einstellung	Beschreibung
  0	(Standardeinstellung) Zeigt an, dass das Optionsfeld nicht aktiviert ist.
  1	Zeigt an, dass das Optionsfeld aktiviert ist.

  Für ein Textfeld-Steuerelement (TextBox) ist die Einstellung der Value-Eigenschaft die gewählte Zeichenfolge oder der gewählte Wert vom Datentyp Numerisch, Datum, DatumZeit, Währung oder Logisch. Die Standardeinstellung ist eine Zeichenfolge.

Hinweise

Die Value-Eigenschaft ist für ein Datenraster-Steuerelement (Grid) nur dann verfügbar, wenn dieses den Fokus besitzt.

Mit der Value-Eigenschaft einer Schaltflächengruppe oder einer Optionsgruppe können Sie feststellen, durch welche Schaltfläche bzw. welches Optionsfeld der Gruppe ein Ereignis ausgelöst wurde. Die Value-Eigenschaft ist auf eine ganze Zahl gesetzt, die der auslösenden Schaltfläche bzw. dem auslösenden Optionsfeld entspricht.

Die Value-Eigenschaft ändert ihr Verhalten, wenn für ein Steuerelement eine Steuerelementherkunft angegeben wird. Bei einer Steuerelementherkunft ist die Einstellung der Value-Eigenschaft eines Steuerelements der Datentyp der Variablen oder des Feldes, auf die bzw. das die ControlSource-Eigenschaft verweist. Wenn der Datentyp des angegebenen Steuerelements nicht gültig ist, generiert Visual FoxPro ein Fehler.

In der folgenden Liste werden die zulässigen Datentypen aufgeführt:

Steuerelement (Control)	Zulässige Datentypen
Kontrollkästchen (CheckBox)	Integer, Logisch, Numerisch
Kombinationsfeld (ComboBox)	Zeichen, Integer, Numerisch
Befehlsschaltflächengruppe (CommandGroup)	Zeichen, Integer, Numerisch
Bearbeitungsfeld (EditBox)	Zeichen, Memo
Datenraster-Steuerelement (Grid)	Numerisch, Zeichen
Listenfeld (ListBox)	Zeichen, Integer, Numerisch
Optionsfeld (OptionButton)	Integer, Logisch, Numerisch
Optionsgruppe (OptionGroup)	Zeichen, Integer, Numerisch
Drehfeld (Spinner)	Währung, Integer, Numerisch
Textfeld (TextBox)	Beliebiger Datentyp

Siehe auch

Bound-Eigenschaft | ListIndex-Eigenschaft

Betrifft: Kontrollkästchen-Steuerelement (CheckBox) | Kombinationsfeld-Steuerelement (ComboBox) | Schaltflächengruppe-Steuerelement (CommandGroup) | Bearbeitungsfeld-Steuerelement (EditBox) | Datenraster-Steuerelement (Grid) | Listenfeld-Steuerelement (ListBox) | Optionsfeld-Steuerelement (OptionButton) | Optionsgruppen-Steuerelement (OptionGroup) | Drehfeld-Steuerelement (Spinner Control) | Textfeld-Steuerelement (TextBox)