Структура LVFINDINFOA (commctrl.h)

  • Статья

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

Синтаксис

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

Члены

flags

Тип: UINT

Тип выполняемого поиска. Для этого элемента можно задать одно или несколько из следующих значений:

Значение Значение
LVFI_PARAM
 Выполняет поиск соответствия между элементом lParam этой структуры и элементом lParam структуры LVITEM элемента.
LVFI_PARTIAL
 Проверяет, начинается ли текст элемента со строки, на которую указывает элемент PSZ . Это значение подразумевает использование LVFI_STRING.
LVFI_STRING
 Выполняет поиск на основе текста элемента. Если не указаны дополнительные значения, текст соответствующего элемента должен точно соответствовать строке, на которую указывает элемент psz . Однако при поиске регистр не учитывается.
LVFI_SUBSTRING
 Windows Vista и более поздних версий. Эквивалентно LVFI_PARTIAL.
LVFI_WRAP
 Если совпадение не найдено, поиск продолжается в начале. Если этот флаг используется сам по себе, предполагается, что поиск строк требуется.
LVFI_NEARESTXY
 Находит элемент, ближайший к позиции, указанной в элементе pt , в направлении, заданном элементом vkDirection . Этот флаг поддерживается только в режимах больших значков и маленьких значков. Если указан LVFI_NEARESTXY, все остальные флаги игнорируются.

psz

Тип: LPCTSTR

Адрес строки с пустым завершением для сравнения с текстом элемента. Он действителен, только если в элементе flags задано LVFI_STRING или LVFI_PARTIAL.

lParam

Тип: LPARAM

Значение для сравнения с элементом lParam структуры LVITEM элемента представления списка. Он действителен, только если LVFI_PARAM задан в элементе flags .

pt

Тип: POINT

Структура POINT с исходной позицией поиска. Он действителен, только если LVFI_NEARESTXY задан в элементе flags .

vkDirection

Тип: UINT

Код виртуального ключа, указывающий направление поиска. Поддерживаются следующие коды:

  • VK_LEFT
  • VK_RIGHT
  • VK_UP
  • VK_DOWN
  • VK_HOME
  • VK_END
  • VK_PRIOR
  • VK_NEXT
Этот член действителен, только если в элементе flags задано LVFI_NEARESTXY.

Комментарии

Примечание

Заголовок commctrl.h определяет LVFINDINFO в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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