Control.AccessibleDescription Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

Control.cs

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, bunu özelliğine Image atar Image ve özelliği olduğundan Textnullve 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, nesnenin AccessibleDescription görsel görünümü hakkında metinsel bir açıklama sağlar. Açıklama öncelikli olarak görme bozukluğu veya görme engelli 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.

Açıklama AccessibleDescription belirgin değilse veya nesnenin AccessibleName, , AccessibleRoleStateve Value özelliklerine göre yedekliyse özelliği gereklidir. Örneğin, "Tamam" içeren bir düğme ek bilgilere ihtiyaç duymaz, ancak bir kaktüsün resmini gösteren bir düğme gerekir. AccessibleNameKaktüs düğmesinin , ve AccessibleRole (ve belki Helpde ) özellikleri amacını açıklardı, ancak AccessibleDescription özellik "Kaktüsün 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