Control.AccessibleDescription Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Control.cs

Возвращает или задает описание элемента управления, используемого клиентскими приложениями специальных возможностей.

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

Значение свойства

String

Описание элемента управления, используемого клиентскими приложениями специальных возможностей. Значение по умолчанию — null.

Примеры

Следующий пример кода создает экземпляр производного CheckBox класса, MyCheckBoxназначает его Image свойству Image и задает AccessibleDescriptionAccessibleName свойства, так как Text это свойство.null В этом примере требуется, чтобы у вас был именованный 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

Комментарии

Свойство объекта AccessibleDescription предоставляет текстовое описание внешнего вида объекта. Описание в основном используется для обеспечения большего контекста для пользователей с низким зрением или слепого зрения, но также может использоваться для поиска контекста или других приложений.

Свойство AccessibleDescription необходимо, если описание не является очевидным или если оно является избыточным на основе свойств объекта AccessibleName, AccessibleRoleStateи Value свойств. Например, кнопка с кнопкой "ОК" не потребует дополнительных сведений, но кнопка, показывающая изображение кактуса. AccessibleName AccessibleRole Свойства и (возможноHelp) для кнопки cactus описывают его назначение, но AccessibleDescription свойство будет передавать информацию, которая менее ощутима, например "Кнопка, показывющая изображение кактуса".

Дополнительные сведения о свойствах доступных объектов см. в разделе "Содержимое описательных свойств".

См. также раздел

• AccessibleName
• AccessibleRole
• AccessibleDefaultActionDescription
• Description