Control.AccessibleDescription Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta la descrizione del controllo usato dalle applicazioni client di accessibilità.

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à

String

Descrizione del controllo usata dalle applicazioni client di accessibilità. Il valore predefinito è null.

Esempio

L'esempio di codice seguente crea un'istanza di una CheckBox classe derivata, MyCheckBox, lo assegna Image alla relativa Image proprietà e imposta le AccessibleName proprietà e AccessibleDescription , perché la Text proprietà è null. In questo esempio è necessario disporre di un Form oggetto denominato 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 sull'aspetto visivo di un oggetto. La descrizione viene usata principalmente per fornire un contesto maggiore per gli utenti a bassa visione o cieco, ma può essere usata anche per la ricerca del contesto o altre applicazioni.

La AccessibleDescription proprietà è necessaria se la descrizione non è ovvia o se è ridondante in base alle proprietà , , Statee Value dell'oggettoAccessibleNameAccessibleRole. Ad esempio, un pulsante con "OK" non avrebbe bisogno di informazioni aggiuntive, ma un pulsante che mostra un'immagine di un cactus sarebbe. Le AccessibleNameproprietà , e (e AccessibleRole forse Help) per il pulsante di cactus descriverebbero il suo scopo, ma la AccessibleDescription proprietà trasmetterebbe informazioni meno tangibili, ad esempio "Un pulsante che mostra un'immagine di un cactus".

Per altre informazioni sulle proprietà degli oggetti accessibili, vedere Contenuto delle proprietà descrittive.

Vedi anche

• AccessibleName
• AccessibleRole
• AccessibleDefaultActionDescription
• Description