Control.AccessibleDescription Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

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

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

String

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

Примеры

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

Комментарии

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

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

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

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

• AccessibleName
• AccessibleRole
• AccessibleDefaultActionDescription
• Description