Control.AccessibleName Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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

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 přístupnosti. Výchozí formát je null.

Příklady

Následující příklad kódu vytvoří instanci CheckBox odvozené třídy , MyCheckBoxpřiřadí ji Image k její Image vlastnosti a nastaví AccessibleName vlastnosti a AccessibleDescription , protože Text vlastnost je null. Tento příklad vyžaduje, abyste měli pojmenovanou FormMyForm.

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 rámci kontejneru, například text v objektu Button, název MenuItemnebo popisek zobrazený vedle TextBox ovládacího prvku.

Další informace o vlastnostech objektů s podporou přístupnosti najdete v části "Obsah popisných vlastností.

Viz také

• AccessibleDescription
• AccessibleRole
• AccessibleDefaultActionDescription
• Name