OptionValue, propriété

S’applique à

Chaque contrôle dans un groupe d’options a une valeur numérique que vous pouvez définir avec la propriété ValeurContrôle. Long en lecture/écriture.

expression.ValeurContrôle

expression Obligatoire. Expression qui renvoie l’un des objets de la liste S’applique à.

Remarques

Lorsque le contrôle est sélectionné, le nombre est affecté au groupe d’options. Si le groupe d’options est lié à un champ, la valeur de la propriété ValeurContrôle du contrôle sélectionné est stockée dans le champ.

Par exemple, ce groupe d’options Region (région) est lié au champ Region dans une table. Le bouton Europe a une définition de propriété ValeurContrôle de 1, le bouton Asia (Asia) une définition de 2, et le bouton Africa (Afrique) une définition de 3. Lorsque l’un de ces boutons est sélectionné, la valeur du groupe d’options Region est identique à la définition de propriété ValeurContrôle pour le contrôle sélectionné. Dans ce cas, le groupe d’options Region étant lié au champ Region, la valeur de ce champ dans la table équivaut également à 2.

Vous pouvez définir la propriété ValeurContrôle à l’aide de la feuille de propriétés du contrôle, d’une macro ou d’un code Visual Basic pour Applications (VBA).

Si vous ne modifiez pas la propriété ValeurContrôle, le premier contrôle que vous placez dans un groupe d’options prend valeur 1, le deuxième contrôle la valeur 2, et ainsi de suite.

La propriété ValeurContrôle est disponible uniquement lorsque le contrôle est placé à l’intérieur d’un contrôle de groupe d’options. Quand une case à cocher, un bouton bascule ou une case d’option ne figurent pas dans un groupe d’options, le contrôle n’a pas de propriété ValeurContrôle. À la place, chaque contrôle a une propriété SourceContrôle, et la valeur de chaque contrôle est Vrai s’il est sélectionné, ou Faux s’il ne l’est pas.

Exemple

L’exemple suivant définit la propriété ValeurContrôle pour trois cases d’option dans le groupe d’options « Ship Method Group » (Groupe des modes de livraison) quand un formulaire s’ouvre. Quand une case d’option est sélectionnée dans le groupe d’options, un message s’affiche, indiquant le numéro d’identification affecté à l’expéditeur.

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