LVFINDINFOW 結構 (commctrl.h)

包含搜尋清單檢視專案時所使用的資訊。此結構與LV_FINDINFO相同，但已重新命名以符合標準命名慣例。

語法

typedef struct tagLVFINDINFOW {
  UINT    flags;
  LPCWSTR psz;
  LPARAM  lParam;
  POINT   pt;
  UINT    vkDirection;
} LVFINDINFOW, *LPFINDINFOW;

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 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。