Właściwość OptionValue

Dotyczy
Access dla Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Dotyczy

Obiekt CheckBox
Obiekt OptionButton
Obiekt ToggleButton

Każda kontrolka w grupie opcji ma wartość liczbową, którą można ustawić przy użyciu właściwości OptionValue (Wartość_ opcji). Właściwość do odczytu i zapisu typu Long (liczba długa).

wyrażenie.OptionValue

Wyrażenie Wymagane. Wyrażenie zwracające jeden z obiektów na liście Dotyczy.

Spostrzeżenia

Po zaznaczeniu kontrolki numer zostaje przypisany do grupy opcji. Jeśli grupa opcji jest powiązana z polem, wartość zaznaczonej właściwości OptionValue (WartośćOpcji) kontrolki jest przechowywana w polu.

Na przykład ta grupa opcji Region jest powiązana z polem Region w tabeli. Przycisk Europa ma ustawienie właściwości OptionValue 1, przycisk Azja ma ustawienie 2, a przycisk Afryka ma ustawienie 3. Po wybraniu jednego z tych przycisków wartość grupy opcji Region będzie taka sama jak wartość właściwości OptionValue (Wartość Opcji) dla wybranej kontrolki. W takim przypadku, ponieważ grupa opcji Region jest powiązana z polem Region, wartość tego pola w tabeli również wynosi 2.

Uwaga

Właściwość OptionValue (WartośćDowartości ) dotyczy tylko pól wyboru, przycisków opcji i przycisków przełączania w grupie opcji.

Właściwość OptionValue (WartośćWartości) można ustawić przy użyciu arkusza właściwości kontrolki, makra lub kodu Visual Basic for Applications (VBA).

O ile nie zmienisz właściwości OptionValue (WartośćOpcji) samodzielnie, pierwsza kontrolka, którą umieścisz w grupie opcji, będzie miała wartość 1, druga — wartość 2 itd.

Właściwość OptionValue (WartośćOpcji) jest dostępna tylko, gdy kontrolka jest umieszczona wewnątrz kontrolki grupy opcji. Jeśli pole wyboru, przycisk przełącznika lub przycisk opcji nie znajduje się w grupie opcji, kontrolka nie ma właściwości OptionValue (WartośćOpcji). Zamiast tego każda taka kontrolka ma właściwość ControlSource (ŹródłoFormantu), a wartość każdej kontrolki to True (Prawda), jeśli zostanie zaznaczona, lub False (Fałsz), jeśli nie zostanie zaznaczona.

Przykład

W poniższym przykładzie ustawiono właściwość OptionValue (WartośćOpcji) dla trzech przycisków opcji w grupie opcji „Ship Method Group” (Grupa metody wysyłki), gdy formularz zostaje otwarty. Po zaznaczeniu przycisku opcji w grupie opcji wyświetla się komunikat wskazujący przypisany identyfikator nadawcy.

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