CTreeCtrl::SetItem

Статья
02/20/2013

Эта функция вызывается, чтобы задать атрибуты указанного элемента представления в виде дерева.

BOOL SetItem(
   TVITEM* pItem 
);
BOOL SetItem(
   HTREEITEM hItem,
   UINT nMask,
   LPCTSTR lpszItem,
   int nImage,
   int nSelectedImage,
   UINT nState,
   UINT nStateMask,
   LPARAM lParam 
);

Параметры

pItem
Указатель на структуру TVITEM, которая содержит новые атрибуты элемента, как описано в Windows SDK.
hItem
Дескриптор элемента, атрибуты которого быть задано.См. раздел элемента hItem структуры TVITEM в Windows SDK.
nMask
Целое число, задающее атрибуты в набор.См. раздел элемента MASK структуры TVITEM.
lpszItem
Адрес строка, содержащая текст элемента.
nImage
Индекс образа элемента в списке образа элемента управления иерархического представления.См. член iImage структуры TVITEM.
nSelectedImage
Индекс образа элемента, выбранного в списке образа элемента управления иерархического представления.См. раздел элемента iSelectedImage структуры TVITEM.
nState
Определяет значения для состояний элемента.См. раздел элемента Состояние структуры TVITEM.
nStateMask
Указывает, какие состояния установить.См. раздел элемента stateMask структуры TVITEM.
lParam
32 Разрядное конкретного приложения значение, связанное с элементом.

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

Ненулевой, если успешно; в противном случае – значение 0.

Заметки

В структуре TVITEM участник hItem указывает элемент, и участник MASK определяет, какие атрибуты в набор.

Если участник MASK или параметр nMask задают значение TVIF_TEXT, то элемент pszText или lpszItem адрес null- завершенной строки и участник cchTextMax игнорировать.Если MASK (или nMask) определяют значение TVIF_STATE, то элемент stateMask или параметр nStateMask определяют, состояниям элемента, который необходимо изменить, и участнику состоянию или параметру nState содержащие значения для этих состояний.

Пример

// Show the item at the point myPoint in bold.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);

if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
   m_TreeCtrl.SetItem(hItem, TVIF_STATE, NULL, 0, 0, TVIS_BOLD, 
      TVIS_BOLD, 0);
}