сообщение TVM_SELECTITEM

Выбирает указанный элемент в виде дерева, прокручивает его в представление или перерисовывает элемент в стиле, используемом для указания целевого объекта операции перетаскивания. Это сообщение можно отправить явно или с помощью макроса TreeView_Select, TreeView_SelectItem или TreeView_SelectDropTarget .

Параметры

wParam

Флаг действия. Этот параметр может иметь одно из следующих значений:

Значение	Значение
TVGN_CARET	Задает для выбора указанный элемент. Родительское окно элемента управления в виде дерева получает коды уведомлений TVN_SELCHANGING и TVN_SELCHANGED .
TVGN_DROPHILITE	Перерисовывает указанный элемент в стиле, используемом для указания целевого объекта операции перетаскивания.
TVGN_FIRSTVISIBLE	Гарантирует, что указанный элемент отображается и, если возможно, отображает его в верхней части окна элемента управления. Элементы управления в виде дерева отображают столько элементов, сколько поместится в окне. Если указанный элемент находится в нижней части иерархии элементов элемента управления, он может не стать первым видимым элементом в зависимости от того, сколько элементов помещается в окне.
TVSI_NOSINGLEEXPAND	При выборе одного элемента гарантирует, что представление в виде дерева не разворачивает дочерние элементы этого элемента. Это допустимо, только если используется с флагом TVGN_CARET. Примечание: Чтобы использовать этот флаг, необходимо предоставить манифест, указывающий Comclt32.dll версии 6.0. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.

lParam

Дескриптор элемента. Если lParam имеет значение NULL, элемент управления не имеет выбранного элемента.

Возвращаемое значение

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае.

Комментарии

Если указанный элемент является дочерним элементом свернутого родительского элемента, список дочерних элементов родительского элемента разворачивается для отображения указанного элемента. В этом случае родительское окно элемента управления получает TVN_ITEMEXPANDING и TVN_ITEMEXPANDED коды уведомлений.

Использование макроса TreeView_SelectItem эквивалентно отправке сообщения TVM_SELECTITEM с параметром wParam со значением TVGN_CARET. Использование макроса TreeView_SelectDropTarget эквивалентно отправке сообщения TVM_SELECTITEM с параметром wParam со значением TVGN_DROPHILITE. Использование TreeView_SelectSetFirstVisible эквивалентно отправке сообщения TVM_SELECTITEM с параметром wParam со значением TVGN_FIRSTVISIBLE.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Commctrl.h