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:

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)