Control.AccessibleDescription Control.AccessibleDescription Control.AccessibleDescription Control.AccessibleDescription Property

Definizione

Ottiene o imposta la descrizione del controllo usato dalle applicazioni client di accessibilità.Gets or sets the description of the control used by accessibility client applications.

public:
 property System::String ^ AccessibleDescription { System::String ^ get(); void set(System::String ^ value); };
public string AccessibleDescription { get; set; }
member this.AccessibleDescription : string with get, set
Public Property AccessibleDescription As String

Valore della proprietà

Descrizione del controllo usata dalle applicazioni client di accessibilità.The description of the control used by accessibility client applications. Il valore predefinito è null.The default is null.

Esempi

L'esempio di codice seguente crea un'istanza di un CheckBox classe, derivata MyCheckBox, assegna un Image al relativo Image proprietà e i set del AccessibleName e AccessibleDescription proprietà, perché il Text è di proprietà null.The following code example creates an instance of a CheckBox derived class, MyCheckBox, assigns it an Image to its Image property and sets the AccessibleName and AccessibleDescription properties, because the Text property is null. In questo esempio è necessario disporre una Form denominato MyForm.This example requires that you have a Form named 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

Commenti

Un oggetto AccessibleDescription proprietà fornisce una descrizione testuale sull'aspetto visivo dell'oggetto.An object's AccessibleDescription property provides a textual description about an object's visual appearance. La descrizione viene utilizzata principalmente per fornire un contesto più bassa non vedenti o con utenti, ma è anche utilizzabile per la ricerca rapida o altre applicazioni.The description is primarily used to provide greater context for low-vision or blind users, but can also be used for context searching or other applications.

Il AccessibleDescription proprietà è necessaria se la descrizione non è ovvia o, se è ridondante base dell'oggetto AccessibleName, AccessibleRole, State, e Value proprietà.The AccessibleDescription property is needed if the description is not obvious, or if it is redundant based on the object's AccessibleName, AccessibleRole, State, and Value properties. Ad esempio, un pulsante "OK" il quale non richiede informazioni aggiuntive, ma sarebbe un pulsante che mostra l'immagine di una funzione.For example, a button with "OK" would not need additional information, but a button that shows a picture of a cactus would. Il AccessibleName, e AccessibleRole (ed eventualmente Help) le proprietà per la funzione di tale pulsante indichi il suo scopo, ma il AccessibleDescription proprietà può contenere informazioni che è meno tangibile, ad esempio "Un pulsante che mostra l'immagine di una funzione di tale".The AccessibleName, and AccessibleRole (and perhaps Help) properties for the cactus button would describe its purpose, but the AccessibleDescription property would convey information that is less tangible, such as "A button that shows a picture of a cactus."

Per altre informazioni sulle proprietà di oggetti accessibili, vedere al contenuto della proprietà descrittive.For more information about properties of accessible objects, see Content of Descriptive Properties.

Si applica a

Vedi anche