Control.AccessibleName プロパティ

  • [アーティクル]

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

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

プロパティ値

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

解説

AccessibleName プロパティは、 Button のテキスト、 MenuItem の名前、 TextBox コントロールの横に表示されるラベルなど、コンテナ内のオブジェクトを簡潔に説明し、識別するラベルです。

アクセス可能なオブジェクトのプロパティについては、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 クラス | Control メンバ | System.Windows.Forms 名前空間 | AccessibleDescription | AccessibleRole | AccessibleDefaultActionDescription | Name