CTreeCtrl::MapAccIdToItem

映射指定的可访问性标识符到一个树视图项目中处理在当前树视图控件的。

HTREEITEM MapAccIdToItem(
          UINT uAccId
) const;

参数

Parameter

描述

[in] uAccId

一个元素的可访问性标识符在树视图项。

返回值

为对应于 uAccId 参数的树视图项目 (HTREEITEM) 的句柄。有关更多信息,请参见 TVITEMEX 结构的 hItem 成员。

备注

辅助功能是帮助残障人士使用利用计算机的应用程序。IAccessible 接口在窗口中用于辅助功能标识符唯一地指定元素。有关辅助功能标识符的更多信息,搜索“有关 Active Accessibility 支持”主题 Microsoft Developer Network

此方法发送 TVM_MAPACCIDTOHTREEITEM 信息,在 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;

下面的代码示例使用辅助功能标识符和 CTreeCtrl::MapAccIdToItem 方法检索处理到根树视图项。该示例使用处理和 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));

请参见

参考

CTreeCtrl选件类

层次结构图

TVM_MAPACCIDTOHTREEITEM

TVITEMEX

CTreeCtrl::MapItemToAccID