Control.AccessibleDescription Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

Control.cs

Ottiene o imposta la descrizione del controllo utilizzato 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 utilizzato dalle applicazioni client di accessibilità. Il valore predefinito è null.

Esempio

Nell'esempio di codice seguente viene creata un'istanza di una CheckBox classe derivata, MyCheckBox, a cui viene assegnato un oggetto Image alla relativa Image proprietà e vengono impostate le AccessibleName proprietà e AccessibleDescription , poiché la Text proprietà è null. In questo esempio è necessario disporre di un Form 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 ipovedenti o non vedenti, ma può essere usata anche per la ricerca del contesto o per altre applicazioni.

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

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

Vedi anche

• AccessibleName
• AccessibleRole
• AccessibleDefaultActionDescription
• Description