Control.AccessibleDescription Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Erişilebilirlik istemci uygulamaları tarafından kullanılan denetimin açıklamasını alır veya ayarlar.

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

Özellik Değeri

String

Erişilebilirlik istemci uygulamaları tarafından kullanılan denetimin açıklaması. Varsayılan değer: null.

Örnekler

Aşağıdaki kod örneği, türetilmiş bir CheckBox sınıfın örneğini oluşturur, özelliğine Image bir Image atar ve özelliği olduğundan nullText ve AccessibleDescription özelliklerini ayarlarAccessibleName. MyCheckBox Bu örnekte adlı MyFormbir Form olması gerekir.

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

Açıklamalar

Nesnenin özelliği, AccessibleDescription bir nesnenin görsel görünümü hakkında metinsel bir açıklama sağlar. Açıklama öncelikli olarak görme bozukluğu veya kör kullanıcılar için daha fazla bağlam sağlamak için kullanılır, ancak bağlam araması veya diğer uygulamalar için de kullanılabilir.

ÖzellikAccessibleDescription, açıklama belirgin değilse veya nesnenin AccessibleName, , AccessibleRoleStateve Value özelliklerine göre yedekliyse gereklidir. Örneğin, "Tamam" içeren bir düğme ek bilgi gerektirmeyebilir, ancak bir kaktüs resmi gösteren bir düğme gerekir. AccessibleNameKaktüs düğmesinin , ve AccessibleRole (ve belki de Help) özellikleri amacını açıklardı, ancak AccessibleDescription özellik "Kaktüs resmini gösteren bir düğme" gibi daha az somut bilgileri iletebilir.

Erişilebilir nesnelerin özellikleri hakkında daha fazla bilgi için bkz. Açıklayıcı Özelliklerin İçeriği.

Ayrıca bkz.

• AccessibleName
• AccessibleRole
• AccessibleDefaultActionDescription
• Description