Label.UseMnemonic Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si le contrôle interprète un caractère esperluette (&) dans la propriété du Text contrôle comme un caractère de préfixe de clé d’accès.

public:
 property bool UseMnemonic { bool get(); void set(bool value); };

public bool UseMnemonic { get; set; }

member this.UseMnemonic : bool with get, set

Public Property UseMnemonic As Boolean

Valeur de propriété

Boolean

true si l’étiquette n’affiche pas le caractère esperluette et souligne le caractère après l’esperluette dans son texte affiché et traite le caractère souligné comme une touche d’accès ; sinon, false si le caractère esperluette est affiché dans le texte du contrôle. La valeur par défaut est true.

Exemples

L’exemple de code suivant montre comment créer un Label contrôle qui a une bordure en trois dimensions et une image affichée à l’aide des ImageList propriétés et ImageIndex . Le contrôle a également un légende avec un caractère mnémonique spécifié. L’exemple de code utilise les PreferredHeight propriétés et PreferredWidth pour dimensionner correctement le Label contrôle sur le formulaire sur lequel il est affiché. Cet exemple nécessite qu’un ImageList a été créé et nommé imageList1 et qu’il ait chargé deux images. L’exemple exige également que le code se trouve dans un formulaire auquel l’espace de System.Drawing noms est ajouté.

public:
   void CreateMyLabel()
   {
      // Create an instance of a Label.
      Label^ label1 = gcnew Label;
      
      // Set the border to a three-dimensional border.
      label1->BorderStyle = System::Windows::Forms::BorderStyle::Fixed3D;
      // Set the ImageList to use for displaying an image.
      label1->ImageList = imageList1;
      // Use the second image in imageList1.
      label1->ImageIndex = 1;
      // Align the image to the top left corner.
      label1->ImageAlign = ContentAlignment::TopLeft;
      
      // Specify that the text can display mnemonic characters.
      label1->UseMnemonic = true;
      // Set the text of the control and specify a mnemonic character.
      label1->Text = "First &Name:";
      
      /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
      label1->Size = System::Drawing::Size( label1->PreferredWidth, label1->PreferredHeight );
      
      //...Code to add the control to the form...
   }

public void CreateMyLabel()
{
   // Create an instance of a Label.
   Label label1 = new Label();

   // Set the border to a three-dimensional border.
   label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D;
   // Set the ImageList to use for displaying an image.
   label1.ImageList = imageList1;
   // Use the second image in imageList1.
   label1.ImageIndex = 1;
   // Align the image to the top left corner.
   label1.ImageAlign = ContentAlignment.TopLeft;

   // Specify that the text can display mnemonic characters.
   label1.UseMnemonic = true;
   // Set the text of the control and specify a mnemonic character.
   label1.Text = "First &Name:";
   
   /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
   label1.Size = new Size (label1.PreferredWidth, label1.PreferredHeight);

   //...Code to add the control to the form...
}

Public Sub CreateMyLabel()
    ' Create an instance of a Label.
    Dim label1 As New Label()
       
    ' Set the border to a three-dimensional border.
    label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D
    ' Set the ImageList to use for displaying an image.
    label1.ImageList = imageList1
    ' Use the second image in imageList1.
    label1.ImageIndex = 1
    ' Align the image to the top left corner.
    label1.ImageAlign = ContentAlignment.TopLeft
     
    ' Specify that the text can display mnemonic characters.
    label1.UseMnemonic = True
    ' Set the text of the control and specify a mnemonic character.
    label1.Text = "First &Name:"
       
    ' Set the size of the control based on the PreferredHeight and PreferredWidth values. 
    label1.Size = New Size(label1.PreferredWidth, label1.PreferredHeight)

    '...Code to add the control to the form...
End Sub

Remarques

Si la propriété a la UseMnemonictrue valeur et qu’un caractère mnémonique (un caractère précédé de l’esperluette) est défini dans la Text propriété de Label, appuyez sur ALT+ le caractère mnémonique pour définir le focus sur le contrôle qui suit dans Label l’ordre de tabulation. Vous pouvez utiliser cette propriété pour fournir une navigation au clavier appropriée vers les contrôles de votre formulaire.

Voir aussi

• Text