Control.AccessibleDescription Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece la descripción del control que las aplicaciones cliente de accesibilidad utilizan.

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

Valor de propiedad

String

Descripción del control que las aplicaciones cliente de accesibilidad utilizan. De manera predeterminada, es null.

Ejemplos

El ejemplo de código siguiente crea una instancia de una CheckBox clase derivada, MyCheckBox, la Image asigna a su Image propiedad y establece las AccessibleName propiedades y AccessibleDescription , porque la Text propiedad es null. En este ejemplo se requiere que tenga un Form elemento denominado 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

Comentarios

La propiedad de AccessibleDescription un objeto proporciona una descripción textual sobre la apariencia visual de un objeto. La descripción se usa principalmente para proporcionar un contexto mayor para los usuarios ciegos o de visión baja, pero también se puede usar para la búsqueda de contexto u otras aplicaciones.

La AccessibleDescription propiedad es necesaria si la descripción no es obvia o si es redundante en función de las propiedades , AccessibleRole, Statey Value del AccessibleNameobjeto. Por ejemplo, un botón con "Ok" no necesitaría información adicional, sino un botón que muestra una imagen de un cactus. Las AccessibleNamepropiedades , y AccessibleRole (y quizás Help) para el botón de cactus describirían su propósito, pero la AccessibleDescription propiedad transmitiría información que es menos tangible, como "Un botón que muestra una imagen de un cactus".

Para obtener más información sobre las propiedades de los objetos accesibles, vea Contenido de propiedades descriptivas.

Se aplica a

Consulte también