макрос ListView_SetCallbackMask (commctrl.h)

Статья
10/24/2024

Изменяет маску обратного вызова для элемента управления представлением списка. Этот макрос можно использовать или явно отправить сообщение LVM_SETCALLBACKMASK.

Синтаксис

BOOL ListView_SetCallbackMask(
   HWND hwnd,
   UINT mask
);

Параметры

hwnd

Тип: HWND

Дескриптор элемента управления "Представление списка".

mask

Тип: UINT

Значение маски обратного вызова. Биты маски указывают состояния элемента или изображения, для которых приложение хранит текущие данные о состоянии. Это значение может быть любым сочетанием следующих констант:

Ценность	Значение
LVIS_CUT	Элемент помечается для операции выреза и вставки.
LVIS_DROPHILITED	Элемент выделен как целевой объект перетаскивания.
LVIS_FOCUSED	Элемент имеет фокус.
LVIS_SELECTED	Выбран элемент.
LVIS_OVERLAYMASK	Приложение сохраняет индекс списка изображений текущего изображения для каждого элемента.
LVIS_STATEIMAGEMASK	Приложение сохраняет индекс списка изображений текущего образа для каждого элемента.

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

Тип: BOOL

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

Замечания

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

Дополнительные сведения о наложении изображений и изображений состояний см. в List-View списках изображений.

Дополнительные сведения о обратных вызовах представления списка см. в элементах обратного вызова и маске обратного вызова

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h

См. также

LVN_GETDISPINFO

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