LB_SETCARETINDEX訊息

在多重選取清單方塊中,將焦點矩形設定為位於指定索引處的專案。 如果看不到專案,則會捲動到檢視中。

參數

wParam

指定要接收焦點矩形之清單方塊專案之以零起始的索引。

Windows 95/Windows 98/Windows) (Windows版:wParam參數限制為 16 位值。 這表示清單方塊不能包含超過 32,767 個專案。 雖然專案數目受到限制,但是清單方塊中專案的總大小以位元組為單位,只會受限於可用的記憶體。

lParam

如果此值為 FALSE,則會捲動專案,直到它完全可見為止;如果為 TRUE,則會捲動專案,直到至少部分顯示為止。

傳回值

如果發生錯誤,傳回值會LB_ERR (-1) 。 否則會傳回 LB_OKAY (0) 。

備註

如果此訊息傳送至不包含選取專案的單一選取清單方塊,插入號索引會設定為 wParam 參數所指定的專案。 如果單一選取清單方塊包含選取的專案,清單方塊會傳回LB_ERR。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限桌面應用程式]
標頭
Winuser.h (包含 Windows.h)

另請參閱

LB_GETCARETINDEX