Control.AccessibleDescription プロパティ
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザー補助クライアント アプリケーションによって使用される、コントロールの説明を取得または設定します。
public:
property System::String ^ AccessibleDescription { System::String ^ get(); void set(System::String ^ value); };public string AccessibleDescription { get; set; }public string? AccessibleDescription { get; set; }member this.AccessibleDescription : string with get, setPublic Property AccessibleDescription As Stringユーザー補助クライアント アプリケーションによって使用されるコントロールの説明。 既定値は、null です。
次のコード例では、派生クラス のインスタンスをCheckBox作成し、 MyCheckBoxプロパティに Image を割り当てImage、 プロパティが であるため、 プロパティと AccessibleDescription プロパティをText設定AccessibleNameしますnull。 この例では、 という名前MyFormの が必要ですForm。
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
オブジェクトの AccessibleDescription プロパティは、オブジェクトの外観に関するテキスト記述を提供します。 この説明は主に、視覚障穙者や盲目のユーザーに対してより大きなコンテキストを提供するために使用されますが、コンテキスト検索やその他のアプリケーションにも使用できます。
AccessibleDescription説明が明確でない場合、またはオブジェクトAccessibleNameの 、AccessibleRoleState、、および Value プロパティに基づいて冗長な場合は、 プロパティが必要です。 たとえば、"OK" のボタンには追加情報は必要ありませんが、サボテンの画像を示すボタンは必要です。 サボテン ボタンの 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 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。