Control.AccessibleDescription Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Control.cs

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; }

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 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 vlastnost je null. 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 objektu AccessibleDescription poskytuje textový popis o vizuálním vzhledu objektu. Popis se primárně používá k poskytování širšího kontextu pro slabozraké nebo nevidomé uživatele, ale dá se použít také k vyhledávání kontextu nebo k jiným aplikacím.

Vlastnost AccessibleDescription je nutná, pokud popis není zřejmý nebo pokud je redundantní na základě objektu AccessibleName, AccessibleRole, Statea Value vlastnosti. 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 kaktusové tlačítko by popsaly svůj účel, ale AccessibleDescription vlastnost by vyjadřovala informace, které jsou méně hmotné, například "Tlačítko, které zobrazuje obrázek kaktusu".

Další informace ovlastnostech

Viz také

• AccessibleName
• AccessibleRole
• AccessibleDefaultActionDescription
• Description