OptionValue-Eigenschaft (Optionswert)

Gilt für
Access für Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Gilt für

CheckBox-Objekt
OptionButton-Objekt
ToggleButton-Objekt

Jedes Steuerelement in einer Optionsgruppe verfügt über einen numerischen Wert, den Sie mit der OptionValue-Eigenschaft festlegen können. Lang mit Lese-/Schreibzugriff.

Ausdruck.OptionValue

Ausdruck Erforderlich. Ein Ausdruck, der eines der Objekte in der Liste "Gilt für" zurückgibt.

Hinweise

Wenn das Steuerelement ausgewählt ist, wird der Optionsgruppe die Nummer zugewiesen. Wenn die Optionsgruppe an ein Feld gebunden ist, wird der Wert der OptionValue-Eigenschaft des ausgewählten Steuerelements in dem Feld gespeichert.

Diese Optionsgruppe Region ist beispielsweise an das Feld Region in einer Tabelle gebunden. Bei der Schaltfläche Europa ist für die OptionValue-Eigenschaft "1" festgelegt, bei der Schaltfläche Asien lautet die Einstellung "2" und bei Afrika ist "3" festgelegt. Wenn eine dieser Schaltflächen ausgewählt wird, entspricht der Wert der Optionsgruppe Region der Einstellung der OptionValue-Eigenschaft für das ausgewählte Steuerelement. Da die Optionsgruppe Region an das Feld "Region" gebunden ist, beträgt in diesem Fall der Wert dieses Felds in der Tabelle ebenfalls "2".

Hinweis

Die OptionValue-Eigenschaft gilt nur für das Kontrollkästchen, die Optionsschaltfläche und die Umschaltflächensteuerelemente in einer Optionsgruppe.

Sie können die OptionValue-Eigenschaft mithilfe des Eigenschaftenblatts des Steuerelements, eines Makros oder Visual Basic for Applications (VBA)-Code festlegen.

Wenn Sie die OptionValue-Eigenschaft nicht ändern, hat das erste Steuerelement, das Sie in einer Optionsgruppe platzieren, den Wert "1", das zweite Steuerelement den Wert "2" usw.

Die OptionValue-Eigenschaft ist nur verfügbar, wenn das Steuerelement innerhalb eines Optionsgruppen-Steuerelements platziert wird. Wenn sich ein CheckBox-, ToggleButton oder OptionButton-Steuerelement nicht in einer Optionsgruppe befindet, hat das Steuerelement keine OptionValue-Eigenschaft. Statt dessen hat jedes Steuerelement eine ControlSource-Eigenschaft, und der Wert der einzelnen Steuerelemente ist entweder True (wenn ausgewählt) oder False (wenn nicht ausgewählt).

Beispiel

Im folgenden Beispiel wird die OptionValue-Eigenschaft für drei Optionsfelder in der Optionsgruppe "Ship Method Group" festgelegt, wenn ein Formular geöffnet wird. Wenn ein Optionsfeld in der Optionsgruppe ausgewählt wird, wird eine Meldung mit der dem Spediteur zugewiesenen ID-Nummer angezeigt.

Private Sub Form_Open(Cancel As Integer)
    Me.Controls("ABC Couriers").OptionValue = 15876
    Me.Controls("Speedy Delivery").OptionValue = 742
    Me.Controls("Lightning Express").OptionValue = 1256
End Sub
Private Sub Ship_Method_Group_Click()
    MsgBox "The ID for the selected shipper is " &  _
        Me.Controls("Ship Method Group").Value
End Sub