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 CheckBox una classe derivata MyCheckBox, Image , la assegna alla Image proprietà e imposta le AccessibleName proprietà e AccessibleDescription , perché il Text la 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. Per questo esempio è necessario disporre di Form un MyFormoggetto denominato.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

La proprietà di AccessibleDescription un oggetto fornisce una descrizione testuale dell'aspetto visivo di un 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ù ampio per utenti ipovedenti o ipovedenti, ma può essere utilizzato anche per la ricerca del contesto 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.

La AccessibleDescription proprietà è necessaria se la descrizione non è ovvia o se è ridondante in base alle proprietà AccessibleName, AccessibleRole, Statee Value dell'oggetto.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 con "OK" non richiede informazioni aggiuntive, ma un pulsante che mostra un'immagine di un cactus.For example, a button with "OK" would not need additional information, but a button that shows a picture of a cactus would. Le AccessibleNameproprietà, AccessibleRole e (e Helpforse) per il pulsante cactus ne descrivono lo scopo, ma AccessibleDescription la proprietà trasmette informazioni meno tangibili, ad esempio "un pulsante che mostra un'immagine di un cactus".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 ulteriori informazioni sulle proprietà degli oggetti accessibili, vedere contenuto delle proprietà descrittive.For more information about properties of accessible objects, see Content of Descriptive Properties.

Si applica a

Vedi anche