Control.AccessibleDescription プロパティ

[アーティクル]
03/28/2008

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

Public Property AccessibleDescription As String
[C#]
public string AccessibleDescription {get; set;}
[C++]
public: __property String* get_AccessibleDescription();public: __property void set_AccessibleDescription(String*);
[JScript]
public function get AccessibleDescription() : String;public function set AccessibleDescription(String);

プロパティ値

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

解説

オブジェクトの AccessibleDescription プロパティは、オブジェクトの外観に関するテキストによる説明を提供します。この説明は、主に、視力の弱いユーザーや視覚障害があるユーザーのために大きなコンテキストを提供するために使用しますが、コンテキスト検索やその他のアプリケーションでも使用できます。

AccessibleDescription プロパティは、説明が明白でない場合や、オブジェクトの AccessibleName 、 AccessibleRole 、 State 、 Value の各プロパティでは説明が冗長な場合に必要です。たとえば、"OK" のボタンは追加情報を必要としませんが、サボテンの絵柄のボタンの場合は必要になります。サボテンのボタンでは、 AccessibleName プロパティと AccessibleRole プロパティによって (必要に応じて Help プロパティでも) その用途を説明できますが、"サボテンの絵が表示されたボタン" のような実用性の低い情報は、 AccessibleDescription プロパティによって伝えます。

アクセス可能なオブジェクトのプロパティについては、MSDN ライブラリの「Microsoft Active Accessibility」で「Content of Descriptive Properties」のトピックを参照してください。

使用例

[Visual Basic, C#, C++] CheckBox 派生クラス MyCheckBox のインスタンスを作成し、その Image プロパティに Image を割り当て、 Text プロパティが null 参照 (Visual Basic では Nothing) であるため AccessibleName プロパティと AccessibleDescription プロパティを設定する例を次に示します。この例は、 MyForm という名前の Form を作成済みであることを前提にしています。

 
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

[C#] 
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);
}

[C++] 
public:
   MyForm() {
      // Create a 'MyCheckBox' control and
      // display an image on it.
      MyCustomControls::MyCheckBox* myCheckBox = new MyCustomControls::MyCheckBox();
      myCheckBox->Location =  Point(5, 5);
      myCheckBox->Image = Image::FromFile(String::Concat(Application::CommonAppDataPath, S"\\Preview.jpg"));

      // Set the AccessibleName property
      // since there is no Text displayed.
      myCheckBox->AccessibleName = S"Preview";
      myCheckBox->AccessibleDescription =
         S"A toggle button used to show the document preview.";
      this->Controls->Add(myCheckBox);
   }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Control.AccessibleDescription プロパティ

プロパティ値

解説

使用例

必要条件

参照

その他のリソース