Control.AccessibleDescription プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ユーザー補助クライアント アプリケーションによって使用される、コントロールの説明を取得または設定します。

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

プロパティ値

String

ユーザー補助クライアント アプリケーションによって使用されるコントロールの説明。 既定値は、null です。

例

次のコード例では、派生クラス のインスタンスをCheckBox作成し、 MyCheckBoxプロパティに Image を割り当てImage、 プロパティが であるため、 プロパティと AccessibleDescription プロパティをText設定AccessibleNameしますnull。 この例では、 という名前MyFormの が必要ですForm。

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

注釈

オブジェクトの AccessibleDescription プロパティは、オブジェクトの外観に関するテキスト記述を提供します。 この説明は主に、視覚障穙者や盲目のユーザーに対してより大きなコンテキストを提供するために使用されますが、コンテキスト検索やその他のアプリケーションにも使用できます。

AccessibleDescription説明が明確でない場合、またはオブジェクトAccessibleNameの 、AccessibleRoleState、、および Value プロパティに基づいて冗長な場合は、 プロパティが必要です。 たとえば、"OK" のボタンには追加情報は必要ありませんが、サボテンの画像を示すボタンは必要です。 サボテン ボタンの AccessibleName、、 AccessibleRole および (おそらく Help) プロパティは目的を説明しますが AccessibleDescription 、プロパティは"サボテンの画像を示すボタン" など、あまり目に見えにくい情報を伝達します。

アクセス可能なオブジェクトのプロパティの詳細については、「 説明プロパティのコンテンツ」を参照してください。

こちらもご覧ください

• AccessibleName
• AccessibleRole
• AccessibleDefaultActionDescription
• Description