Макрос ListView_MapIndexToID (commctrl.h)

Статья
08/22/2023

Сопоставляет индекс элемента с уникальным идентификатором. Вы можете использовать этот макрос или отправить сообщение LVM_MAPINDEXTOID явным образом.

Синтаксис

void ListView_MapIndexToID(
   hwnd,
   index
);

Параметры

hwnd

Тип: HWND

Дескриптор элемента управления list-view.

index

Тип: UINT

UINT, содержащий индекс элемента.

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

None

Remarks

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

Этот макрос можно использовать для добавления тега к элементу идентификатора при его создании. Этот идентификатор используется для обеспечения уникальности во время существования элемента управления list-view.

Чтобы однозначно идентифицировать элемент, возьмите индекс, возвращаемый вызовом IComponent::GetDisplayInfo , и вызовите LVM_MAPINDEXTOID. Возвращаемое значение является уникальным идентификатором.

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

Чтобы использовать ListView_MapIndexToID, укажите в манифесте Comctl32.dll версии 6. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	commctrl.h

Share via