Control.AccessibleDescription Proprietà

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

Nell'esempio di codice seguente viene creata un'istanza di una classe derivata CheckBox, MyCheckBox, viene assegnata una Image alla relativa proprietà Image e vengono impostate le proprietà AccessibleName e AccessibleDescription, perché la proprietà Text è 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 un 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

La proprietà AccessibleDescription di 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 proprietà AccessibleDescription è necessaria se la descrizione non è ovvia o se è ridondante in base alle proprietà AccessibleName, AccessibleRole, State e 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 proprietà AccessibleName e AccessibleRole (e probabilmente Help) per il pulsante cactus ne descrivono lo scopo, ma la proprietà AccessibleDescription comunicherà 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