CTreeCtrl::MapItemToAccID
現在のツリー ビュー コントロール内のツリー ビュー アイテムの指定されたハンドルをアクセシビリティ識別子に割り当てます。
UINT MapItemToAccID(
HTREEITEM hItem
) const;
パラメーター
パラメーター |
説明 |
|---|---|
[入力] hItem |
コントロールのツリー ビュー アイテムのハンドル。 詳細については、TVITEMEX 構造体の hItem メンバーを参照してください。 |
戻り値
hItem パラメーターに対応するアクセシビリティ識別子。
解説
ユーザー補助とは、障害を持つユーザーのコンピューター利用を支援するアプリケーションのことです。 IAccessible インターフェイスはアクセシビリティ識別子を使用して、ウィンドウ内の要素を一意に指定します。 アクセシビリティ識別子の詳細については、Microsoft Developer Network で「About Active Accessibility Support」のトピックを検索してください。
このメソッドは、TVM_MAPHTREEITEMTOACCID メッセージを送信します。このメッセージについては、Windows SDK を参照してください。
必要条件
**ヘッダー:**afxcmn.h
このメソッドは Windows XP 以降でサポートされています。
このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。
使用例
次のコード例では、現在のツリー ビュー コントロールにアクセスするために使用される変数 m_treeCtrl を定義しています。 コード例では、符号なし整数といくつかの HTREEITEM 変数も定義しています。 これらの変数は、次の例で使用されます。
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
次のコード例では、ツリー ビュー コントロール アイテムの識別番号を取得します。 ここには示されていないコード例の前半では、ルート ノードである米国ノード、ペンシルバニア州とワシントン州を表すサブノード、およびこれらの州の都市を表すツリー アイテムから構成されるツリー ビューを作成しました。 このコード例では、ルート国ノードの一意の識別番号を取得します。
// Map an accessibility identifier to the Pennsylvania node.
accIdUS = m_treeCtrl.MapItemToAccId( hCountry );