Элементы обратного вызова и маска обратного вызова

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

Элемент определяется как элемент обратного вызова путем указания соответствующих значений для pszText структуры и iImage элементов структуры (см. раздел CListCtrl::GetItem).LVITEM Если приложение поддерживает текст элемента или дочернего элемента, укажите значение LPSTR_TEXTCALLBACK элемента pszText . Если приложение отслеживает значок элемента, укажите значение I_IMAGECALLBACK элемента iImage .

Помимо определения элементов обратного вызова, можно также изменить маску обратного вызова элемента управления. Эта маска представляет собой набор битовых флагов, указывающих состояния элементов, для которых приложение, а не элемент управления, сохраняет текущие данные. Маска обратного вызова применяется ко всем элементам элемента управления, в отличие от обозначения элемента обратного вызова, которое применяется к конкретному элементу. Маска обратного вызова по умолчанию равна нулю, то есть элемент управления отслеживает все состояния элементов. Чтобы изменить это поведение по умолчанию, инициализировать маску в любое сочетание следующих значений:

• LVIS_CUT Элемент помечается для операции выреза и вставки.

• LVIS_DROPHILITED Элемент выделен как целевой объект перетаскивания.

• LVIS_FOCUSED Элемент имеет фокус.

• LVIS_SELECTED Выбран элемент.

• LVIS_OVERLAYMASK Приложение сохраняет индекс списка изображений текущего образа наложения для каждого элемента.

• LVIS_STATEIMAGEMASK приложение сохраняет индекс списка изображений текущего образа для каждого элемента.

Дополнительные сведения о получении и настройке этой маски см. в разделе CListCtrl::GetCallbackMask и CListCtrl::SetCallbackMask.

См. также

Использование CListCtrl
Controls