Esta documentación está archivada y no tiene mantenimiento.

Control.AccessibleDescription (Propiedad)

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

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

[LocalizableAttribute(true)] 
public string AccessibleDescription { get; set; }
/** @property */
public String get_AccessibleDescription ()

/** @property */
public void set_AccessibleDescription (String value)

public function get AccessibleDescription () : String

public function set AccessibleDescription (value : String)

No aplicable.

Valor de propiedad

Descripción del control que las aplicaciones cliente de accesibilidad utilizan. El valor predeterminado es referencia null (Nothing en Visual Basic).

La propiedad AccessibleDescription de un objeto proporciona una descripción de texto acerca de la apariencia del objeto. La descripción se utiliza principalmente para suministrar más contexto a los usuarios ciegos o con deficiencias visuales, pero también puede utilizarse para llevar a cabo operaciones de búsqueda de contexto o para otras aplicaciones.

La propiedad AccessibleDescription es necesaria si la descripción no es clara o si es redundante con respecto a las propiedades AccessibleName, AccessibleRole, State y Value del objeto. Por ejemplo, un botón con la etiqueta “Aceptar” no necesita información adicional, pero un botón que muestra una imagen de un cactus sí que necesita esta información. Las propiedades AccessibleName y AccessibleRole (y quizás Help) del botón de cactus podrían describir su finalidad, pero la propiedad AccessibleDescription transmitiría información menos tangible como, por ejemplo, “Botón que muestra una imagen de un cactus".

Para obtener más información acerca de las propiedades de los objetos accesibles, vea el tema "Content of Descriptive Properties" en MSDN Library, en http://msdn.microsoft.com/library/spa.

En el siguiente ejemplo de código se crea una instancia de una clase derivada de CheckBox, denominada MyCheckBox, se asigna Image a su propiedad Image y se establece el valor de las propiedades AccessibleName y AccessibleDescription, ya que el valor de la propiedad Text es referencia null (Nothing en Visual Basic). Este ejemplo requiere que haya un objeto Form denominado MyForm.

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 MyForm()
{
    // Create a 'MyCheckBox' control and 
    // display an image on it.
    MyCustomControls.MyCheckBox myCheckBox = 
        new MyCustomControls.MyCheckBox();
    myCheckBox.set_Location(new Point(5, 5));
    myCheckBox.set_Image(Image.FromFile(Application.get_CommonAppDataPath() 
        + "\\Preview.jpg"));
    // Set the AccessibleName property
    // since there is no Text displayed.
    myCheckBox.set_AccessibleName("Preview");
    myCheckBox.set_AccessibleDescription(
        "A toggle button used to show the document preview.");
    this.get_Controls().Add(myCheckBox);
} //MyForm

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar: