Control.AccessibleName Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el nombre del control que las aplicaciones cliente de accesibilidad utilizan.
public:
property System::String ^ AccessibleName { System::String ^ get(); void set(System::String ^ value); };
public string AccessibleName { get; set; }
public string? AccessibleName { get; set; }
member this.AccessibleName : string with get, set
Public Property AccessibleName As String
Valor de propiedad
Nombre del control que las aplicaciones cliente de accesibilidad utilizan. De manera predeterminada, es null
.
Ejemplos
En el ejemplo de código siguiente se crea una instancia de una CheckBox clase derivada, MyCheckBox
, se le asigna a Image su Image propiedad y se establecen las AccessibleName propiedades y AccessibleDescription , ya que 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 AccessibleName propiedad es una etiqueta que describe e identifica brevemente el objeto dentro de su contenedor, como el texto de un Button, el nombre de o MenuItemuna etiqueta que se muestra junto a un TextBox control .
Para obtener más información sobre las propiedades de los objetos accesibles, vea "Contenido de propiedades descriptivas.