Поделиться через


CListCtrl::SetItem

Устанавливает некоторые или все атрибуты элемента списка.

BOOL SetItem( 
   const LVITEM* pItem  
); 
BOOL SetItem( 
   int nItem, 
   int nSubItem, 
   UINT nMask, 
   LPCTSTR lpszItem, 
   int nImage, 
   UINT nState, 
   UINT nStateMask, 
   LPARAM lParam  
); 
BOOL SetItem( 
   int nItem, 
   int nSubItem, 
   UINT nMask, 
   LPCTSTR lpszItem, 
   int nImage, 
   UINT nState, 
   UINT nStateMask, 
   LPARAM lParam, 
   int nIndent  
);

Параметры

  • pItem
    Адрес структуры LVITEM, которая содержит новые атрибуты элемента, как описано в Windows SDK. Члены iItem и iSubItem структуры определяют элемент или подэлемента, и участник MASK структуры определяет, какие атрибуты в набор. Дополнительные сведения о члене MASK см. в разделе Примечания.

  • nItem
    Индекс элемента, атрибуты которого требуется задать.

  • nSubItem
    Индекс подэлемента, атрибуты которого требуется задать.

  • nMask
    Указывает, какие атрибуты быть установлен (см. примечания).

  • lpszItem
    Адрес null- завершенной строки, определяющее метку элемента.

  • nImage
    Индекс образа элемента в списке образа.

  • nState
    Определяет значения для состояний, подлежащий изменению (см. примечания).

  • nStateMask
    Указывает, какие состояния изменением (см. примечания).

  • lParam
    32 Разрядное конкретного приложения значение, которое необходимо связать с элементом.

  • nIndent
    Ширина (в точках) отступа. Если nIndent, чем система- указанная минимальная ширина, новая ширина установлена на система- указанному минимума

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

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

Заметки

Члены iItem и iSubItem структуры LVITEM и параметров nItem и nSubItem определяют элемента и подэлементов атрибуты которого требуется задать.

Элемент MASK структуры LVITEM и параметр nMask определяют, какие атрибуты элемента должно быть установлено:

  • LVIF_TEXT элемент pszText или параметр lpszItem адрес null- завершенной строк; элемент cchTextMax игнорировать.

  • LVIF_STATE элемент stateMask или параметр nStateMask определяет, состояниям элемента, который необходимо изменить, и участнику состоянию или параметру nState содержащие значения для этих состояний.

Пример

См. пример для CListCtrl::HitTest.

Требования

Header: afxcmn.h

См. также

Ссылки

Класс CListCtrl

Диаграмма иерархии

CListCtrl::GetItem