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 プロパティ

プロパティ値

解説

使用例

必要条件

参照

その他のリソース