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

Статья
10/24/2024

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

Синтаксис

UINT ListView_MapIDToIndex(
   HWND hwnd,
   UINT id
);

Параметры

hwnd

Тип: HWND

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

id

Тип: UINT

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

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

Тип: UINT

Возвращает самый текущий индекс.

Замечания

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

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

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

Если необходимо знать индекс элемента после создания идентификатора, вызовите LVM_MAPIDTOINDEX с уникальным идентификатором и возвращает самый текущий индекс.

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

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

Требования

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

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