CTreeCtrl::MapAccIdToItem
現在のツリー ビュー コントロール内のツリー ビュー アイテムのハンドルに指定したアクセシビリティ識別子を割り当てます。
HTREEITEM MapAccIdToItem(
UINT uAccId
) const;
パラメーター
パラメーター |
説明 |
|---|---|
[入力] uAccId |
ツリー ビュー アイテムの要素のアクセシビリティ識別子。 |
戻り値
uAccId のパラメーターに対応するツリー ビュー アイテム (HTREEITEM) へのハンドル。詳細については、TVITEMEX の構造体の hItem のメンバーを参照してください。
解説
ユーザー補助機能は、障碍のあるユーザーがコンピューターを使用できるアプリケーションです。IAccessible のインターフェイスでアクセシビリティ識別子が一意にウィンドウで要素を指定するために使用されます。アクセシビリティ識別子に関する詳細については、「」のActive Accessibilityのサポートに関するトピックを検索する Microsoft Developer Network。
このメソッドは Windows SDKで説明する TVM_MAPACCIDTOHTREEITEM のメッセージを送信します。
必要条件
ヘッダー: 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;
次のコード例は、アクセシビリティ識別子とルートのツリー ビュー アイテムのハンドルを取得するには CTreeCtrl::MapAccIdToItem のメソッドを使用します。例は、ハンドルおよびその項目の周囲に3Dの四角形の描画に CTreeCtrl::GetItemPartRect のメソッドを使用します。表示されていないコード例では、前のセクションでは、米国のルートの国または地域のノード、およびワシントン州ペンシルバニア状態のサブノードで構成される、これらの状態の都市のツリー項目のツリー ビューを作成しました。ここでは、アクセシビリティ識別子によってルートのツリー ビュー アイテムを関連付けるに CTreeCtrl::MapItemToAccID のメソッドを使用します。
CRect rect;
HTREEITEM hUS = m_treeCtrl.MapAccIdToItem( accIdUS );
m_treeCtrl.GetItemPartRect( hUS, TVGIPR_BUTTON, &rect );
m_treeCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(0, 0, 255));