HeaderPane
Main
Hide
Share Link
Print

TopIndex

Defines the index number of the item shown at the top of the dropdown portion.

C

LONG WINAPI SftBox_GetTopIndex(HWND hwndCtl);
int WINAPI SftBox_SetTopIndex(HWND hwndCtl, LONG index);

C++

LONG CSftBox::GetTopIndex() const;
int CSftBox::SetTopIndex(LONG index);

Parameters

hwndCtl

The window handle of the combo box control.

index

The zero-based index of the item which will become the first item displayed.

Returns

GetTopIndex returns the zero-based index of the item that is displayed as the first item in the dropdown portion.

SetTopIndex returns 0 if the function was successful, otherwise -1 is returned.

Comments

The GetTopIndex and SetTopIndex functions define the index number of the item shown at the top of the dropdown portion.

If the item specified using SetTopIndex is currently not shown, it is made visible (see SetItemShown).

The dropdown portion is not scrolled past the end of the list. If the specified item is close to the end of the list, an item preceding it may become the first item displayed.

See Also C/C++ API | Categories | Notifications


Last Updated 11/21/2026 - (email)
© 2026 Softel vdm, Inc.