ListView_GetISearchString巨集 （commctrl.h）

取得清單檢視控件的累加搜尋字串。 您可以使用此巨集或明確傳送 LVM_GETISEARCHSTRING 訊息。

語法

BOOL ListView_GetISearchString(
   HWND  hwndLV,
   LPSTR lpsz
);

參數

hwndLV

類型：HWND

清單檢視控件的句柄。

lpsz

類型：LPSTR

接收累加搜尋字串之緩衝區的指標。 若要只擷取字串的長度，請將 lpsz 設定為 NULL。

傳回值

類型：BOOL

傳回累加搜尋字串中的字元數，如果清單檢視控件不在累加搜尋模式中，則傳回零。

言論

累加搜尋字串是使用者在清單檢視具有輸入焦點時輸入的字元序列。 每次使用者輸入字元時，系統會將字元附加至搜尋字串，然後搜尋相符的專案。 如果系統找到相符專案，它會選取專案，並視需要將它捲動到檢視中。

逾時期間與使用者輸入的每個字元相關聯。 如果使用者輸入另一個字元之前經過逾時期間，則會重設累加式搜尋字串。

請確定緩衝區夠大，足以保存字串。 如果太小，則會導致立即無效的頁面錯誤。

要求