Control.AccessibleName Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o nome do controle usado por aplicativos cliente de acessibilidade.

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 da propriedade

String

O nome do controle usado por aplicativos cliente de acessibilidade. O padrão é null.

Exemplos

O exemplo de código a seguir cria uma instância de uma CheckBox classe derivada, MyCheckBox, atribui-a Image a sua Image propriedade e define as AccessibleName propriedades e AccessibleDescription , uma vez que a Text propriedade é null. Este exemplo exige que você tenha um Form chamado 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

Comentários

A AccessibleName propriedade é um rótulo que descreve e identifica brevemente o objeto dentro de seu contêiner, como o texto em um Button, o nome de um MenuItemou um rótulo exibido ao lado de um TextBox controle.

Para obter mais informações sobre propriedades de objetos acessíveis, consulte o "Conteúdo de Propriedades Descritivas.

Aplica-se a

Partilhar via