OptionValue-Eigenschaft (Optionswert)

Gilt für

Jedes Steuerelement in einer Optionsgruppe hat 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.

Beispiel: Die Optionsgruppe Region ist in einer Tabelle an das Feld "Region" 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".

Sie können die OptionValue-Eigenschaft mit dem Eigenschaftenblatt des Steuerelements, einem Makro oder mit VBA-Code (Visual Basic for Applications) 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