Udostępnij za pośrednictwem


Control.AccessibleDescription Właściwość

Definicja

Pobiera lub ustawia opis kontrolki używanej przez aplikacje klienckie ułatwień dostępu.

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

Wartość właściwości

Opis kontrolki używanej przez aplikacje klienckie ułatwień dostępu. Wartość domyślna to null.

Przykłady

Poniższy przykład kodu tworzy wystąpienie klasy pochodnej , przypisuje go Image do właściwości Image i ustawia AccessibleName właściwości iAccessibleDescription, ponieważ Text właściwość to null. MyCheckBoxCheckBox W tym przykładzie jest wymagana nazwana 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

Uwagi

Właściwość obiektu AccessibleDescription zawiera tekstowy opis wyglądu obiektu. Opis jest używany głównie w celu zapewnienia większego kontekstu dla użytkowników o niskim poziomie widzenia lub niewidomych, ale może być również używany do wyszukiwania kontekstu lub innych aplikacji.

Właściwość jest wymagana AccessibleDescription , jeśli opis nie jest oczywisty lub jeśli jest nadmiarowy na podstawie właściwości AccessibleNameobiektu , AccessibleRole, Statei Value . Na przykład przycisk z przyciskiem "OK" nie będzie potrzebował dodatkowych informacji, ale przycisk przedstawiający obraz kaktusu. AccessibleNameWłaściwości , i AccessibleRole (i być może Help) dla przycisku kaktus opisać jego przeznaczenie, ale AccessibleDescription właściwość przekaże informacje, które są mniej namacalne, takie jak "Przycisk, który pokazuje obraz kaktusu.

Aby uzyskać więcej informacji na temat właściwości dostępnych obiektów, zobacz Zawartość właściwości opisowych.

Dotyczy

Zobacz też