この記事は翻訳者によって翻訳されたものです。 記事の文章にポインターを重ねると、原文のテキストが表示されます。 |
訳文
原文
|
Control.AccessibleDescription プロパティ
ユーザー補助クライアント アプリケーションによって使用される、コントロールの説明を取得または設定します。
アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)
オブジェクトの AccessibleDescription プロパティは、オブジェクトの外観に関するテキストによる説明を提供します。 この説明は、主に、視力の弱いユーザーや視覚障害があるユーザーのために大きなコンテキストを提供するために使用しますが、コンテキスト検索やその他のアプリケーションでも使用できます。
AccessibleDescription プロパティは、説明が明白でない場合や、オブジェクトの AccessibleName、AccessibleRole、State、Value の各プロパティでは説明が冗長な場合に必要です。 たとえば、"OK" のボタンは追加情報を必要としませんが、サボテンの絵柄のボタンの場合は必要になります。 サボテンのボタンでは、AccessibleName プロパティと AccessibleRole プロパティによって (必要に応じて Help プロパティでも) その用途を説明できますが、"サボテンの絵が表示されたボタン" のような実用性の低い情報は、AccessibleDescription プロパティによって伝えます。
ユーザー補助オブジェクトのプロパティの詳細については、MSDN ライブラリ (http://msdn.microsoft.com/ja-jp/library/default.aspx.) の「Content of Descriptive Properties」を参照してください。
CheckBox 派生クラス MyCheckBox のインスタンスを作成し、その Image プロパティに Image を割り当て、Text プロパティが null であるため AccessibleName プロパティと AccessibleDescription プロパティを設定するコード例を次に示します。 この例では、MyForm という名前の Form が存在している必要があります。
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); }
Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2
.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
