Control.AccessibleName Control.AccessibleName Control.AccessibleName Control.AccessibleName Property

定义

获取或设置辅助功能客户端应用程序所使用的控件名称。Gets or sets the name of the control used by accessibility client applications.

public:
 property System::String ^ AccessibleName { System::String ^ get(); void set(System::String ^ value); };
public string AccessibleName { get; set; }
member this.AccessibleName : string with get, set
Public Property AccessibleName As String

属性值

辅助功能客户端应用程序所使用的控件名称。The name of the control used by accessibility client applications. 默认值为 nullThe default is null.

示例

下面的CheckBox代码示例创建派生类的实例, MyCheckBox并将其Image分配给其Image属性,并设置AccessibleNameAccessibleDescription属性,因为Text属性为nullThe following code example creates an instance of a CheckBox derived class, MyCheckBox, assigns it an Image to its Image property and sets the AccessibleName and AccessibleDescription properties since the Text property is null. 此示例要求您具有名为Form MyForm的。This example requires that you have a Form named 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

注解

属性是一个标签,用于简要描述和标识其容器中的对象,例如Button中的文本、的名称MenuItem或显示在TextBox控件旁边的标签。 AccessibleNameThe AccessibleName property is a label that briefly describes and identifies the object within its container, such as the text in a Button, the name of a MenuItem, or a label displayed next to a TextBox control.

有关可访问对象的属性的详细信息,请参阅 "描述性属性的内容"。For more information about properties of accessible objects, see the "Content of Descriptive Properties.

适用于

另请参阅