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 成員與專案 LVITEM 結構 lParam 成員之間的相符專案。
LVFI_PARTIAL	檢查項目文字是否以 psz 所指向的字串開頭，成員。這個值表示使用 LVFI_STRING。
LVFI_STRING	根據專案文字搜尋。除非指定其他值，否則比對專案的專案文字必須與 psz 成員指向的字串完全相符。不過，搜尋不區分大小寫。
LVFI_SUBSTRING	Windows Vista 和更新版本。相當於 LVFI_PARTIAL。
LVFI_WRAP	如果找不到相符專案，則會在開頭繼續搜尋。如果單獨使用此旗標，則會假設需要字串搜尋。
LVFI_NEARESTXY	根據 vkDirection 成員所指定的方向，尋找最接近 pt 成員中所指定位置的專案。只有大型圖示和小型圖示模式才支援此旗標。如果指定LVFI_NEARESTXY，則會忽略所有其他旗標。

psz

類型：LPCTSTR

要與專案文字比較之 Null 終止字串的位址。只有在LVFI_STRING或LVFI_PARTIAL是在 旗標中設定 成員時才有效。

lParam

類型：LPARAM

要與清單檢視專案 LVITEM 結構成員 lParam 比較的值。只有在 旗標中設定LVFI_PARAM 成員時才有效。

pt

類型：POINT

POINT 結構與初始搜尋位置。只有在旗標成員中設定LVFI_NEARESTXY時才有效。

vkDirection

類型：UINT

指定搜尋方向的虛擬索引鍵程序代碼。支援下列程式代碼：

只有在 旗標中設定LVFI_NEARESTXY 成員時，這個成員才有效。

注意

commctrl.h 標頭會將 LVFINDINFO 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。