Control.AccessibleDescription Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

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

public:
 property System::String ^ AccessibleDescription { System::String ^ get(); void set(System::String ^ value); };
public string AccessibleDescription { get; set; }
public string? AccessibleDescription { get; set; }
member this.AccessibleDescription : string with get, set
Public Property AccessibleDescription As String

Hodnota vlastnosti

String

Popis 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 jeho Image vlastnosti a nastaví AccessibleName a AccessibleDescription vlastnosti, protože Text vlastnost je null. Tento příklad vyžaduje, abyste měli pojmenovanou Form 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 objektu AccessibleDescription poskytuje textový popis o vizuálním vzhledu objektu. Popis se primárně používá k zajištění většího kontextu pro slabozraké nebo nevidomé uživatele, ale můžete ho použít také pro vyhledávání kontextu nebo jiné aplikace.

Vlastnost AccessibleDescription je nutná, pokud popis není zřejmé, nebo pokud je redundantní na základě objektu AccessibleName, , AccessibleRoleStatea Value vlastností. Například tlačítko s ok by nepotřebovalo další informace, ale tlačítko, které zobrazuje obrázek kaktusu. Vlastnosti AccessibleNamea (a AccessibleRole možná Help) pro tlačítko kaktusu by popsaly jeho účel, ale AccessibleDescription vlastnost by vyjadřovala informace, které jsou méně hmatatelné, například "tlačítko, které zobrazuje obrázek kaktusu".

Další informace o vlastnostech přístupných objektů naleznete v tématu Obsah popisných vlastností.

Platí pro

Viz také