CTreeCtrl::MapAccIdToItem
Сопоставляет указанный идентификатор специальных возможностей на дескриптор элемента представления в виде дерева в текущем элементе управления иерархического представления.
HTREEITEM MapAccIdToItem(
UINT uAccId
) const;
Параметры
Параметр |
Описание |
|---|---|
[входящий] uAccId |
Идентификатор специальных возможностей для элемента в элементе представления в виде дерева. |
Возвращаемое значение
Дескриптор к элементу представления в виде дерева (HTREEITEM), что соответствует параметру uAccId. Дополнительные сведения см. в разделе hItem члена структуры TVITEMEX.
Заметки
Специальные возможности приложения, которые помогают продажам с физическими нарушениями использовать компьютеры. Идентификатор специальных возможностей используется интерфейсом IAccessible для уникальной идентификации элемента в окне. Дополнительные сведения об идентификаторах со специальными возможностями см. в разделах "об активной поддержке специальных возможностей" 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));