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

Структура 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

Адрес строки, завершаемой значением NULL, для сравнения с текстом элемента. Допустимо только в том случае, если LVFI_STRING или LVFI_PARTIAL заданы в флагах элемента.

lParam

Тип: LPARAM

Значение для сравнения с lParam элементом структуры элемента представления списка. Допустимо только в том случае, если LVFI_PARAM задан в флагах .

pt

Тип: POINT

структура point с исходной позицией поиска. Допустимо только в том случае, если LVFI_NEARESTXY заданы в флагах элемента.

vkDirection

Тип: UINT

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

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

Замечания

Заметка

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

Требования

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