Control.AccessibleDescription 属性
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置辅助功能客户端应用程序使用的控件说明。
public:
property System::String ^ AccessibleDescription { System::String ^ get(); void set(System::String ^ value); };C#
public string AccessibleDescription { get; set; }C#
public string? AccessibleDescription { get; set; }member this.AccessibleDescription : string with get, setPublic Property AccessibleDescription As String辅助功能客户端应用程序使用的控件说明。 默认值为 null。
下面的代码示例创建派生类的 CheckBox 实例， MyCheckBox并将其 Image 分配给其 Image 属性并设置 AccessibleName 和 AccessibleDescription 属性，因为 Text 属性为 null。 此示例要求具有名为 Form 的 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 );
}
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);
}
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如果说明不明显，或者基于对象的 、、 AccessibleRoleState和 Value 属性是冗余的AccessibleName，则需要 属性。 例如，具有“确定”的按钮不需要其他信息，但显示仙人掌图片的按钮需要其他信息。 AccessibleName、 和 AccessibleRole (，也许Help) 仙人掌按钮的属性将描述其用途，但AccessibleDescription属性将传达不太有形的信息，例如“显示仙人掌图片的按钮”。
有关可访问对象的属性的详细信息，请参阅 描述性属性的内容。
| 产品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
