Control.AccessibleName Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Control.cs

Získá nebo nastaví název ovládacího prvku používaného klientskými aplikacemi pro usnadnění přístupu.

public:
 property System::String ^ AccessibleName { System::String ^ get(); void set(System::String ^ value); };

public string? AccessibleName { get; set; }

member this.AccessibleName : string with get, set

Public Property AccessibleName As String

Hodnota vlastnosti

String

Název ovládacího prvku používaného klientskými aplikacemi pro usnadnění přístupu. Výchozí hodnota je null.

Příklady

Následující příklad kódu vytvoří instanci CheckBox odvozené třídy , MyCheckBoxpřiřadí ji Image k jeho Image vlastnosti a nastaví AccessibleName a AccessibleDescription vlastnosti, protože Text je nullvlastnost . Tento příklad vyžaduje, abyste měli Form název MyForm.

public:
   MyForm()
   {
      // Create a 'MyCheckBox' control and
      // display an image on it.
      MyCustomControls::MyCheckBox^ myCheckBox = gcnew MyCustomControls::MyCheckBox;
      myCheckBox->Location = Point(5,5);
      myCheckBox->Image = Image::FromFile( String::Concat( Application::CommonAppDataPath, "\\Preview.jpg" ) );
      
      // Set the AccessibleName property
      // since there is no Text displayed.
      myCheckBox->AccessibleName = "Preview";
      myCheckBox->AccessibleDescription = "A toggle button used to show the document preview.";
      this->Controls->Add( myCheckBox );
   }

public MyForm()
{
   // Create a 'MyCheckBox' control and 
   // display an image on it.
   MyCustomControls.MyCheckBox myCheckBox = 
      new MyCustomControls.MyCheckBox();
   myCheckBox.Location = new Point(5,5);
   myCheckBox.Image = Image.FromFile(
     Application.CommonAppDataPath + "\\Preview.jpg");

   // Set the AccessibleName property
   // since there is no Text displayed.
   myCheckBox.AccessibleName = "Preview";
   myCheckBox.AccessibleDescription =
     "A toggle button used to show the document preview.";
   this.Controls.Add(myCheckBox);
}

Public Sub New()
   ' Create a 'MyCheckBox' control and 
   ' display an image on it. 
   Dim myCheckBox As New MyCustomControls.MyCheckBox()
   myCheckBox.Location = New Point(5, 5)
   myCheckBox.Image = Image.FromFile( _
     Application.CommonAppDataPath + "\Preview.jpg")

   ' Set the AccessibleName property
   ' since there is no Text displayed. 
   myCheckBox.AccessibleName = "Preview"

   ' Set the AccessibleDescription text.
   myCheckBox.AccessibleDescription = _
     "A toggle button used to show the document preview."
   Me.Controls.Add(myCheckBox)
End Sub

Poznámky

Vlastnost AccessibleName je popisek, který stručně popisuje a identifikuje objekt v jeho kontejneru, například text v objektu Button, název MenuItemnebo popisek zobrazený vedle TextBox ovládacího prvku.

Další informace o vlastnostech přístupných objektů naleznete v části Obsah popisných vlastností.

Viz také

• AccessibleDescription
• AccessibleRole
• AccessibleDefaultActionDescription
• Name