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

Статья
10/24/2024

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

Синтаксис

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

Параметры

hwnd

Тип: HWND

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

index

Тип: UINT

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

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

Тип: UINT

Возвращает уникальный идентификатор.

Замечания

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

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

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

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

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

Требования

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

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