Navigation:  thinBasic Modules > UI (User Interface) > Dedicated Control Functions > ListView Control > ListView: Items functions >

ListView_GetNextItem

Previous pageReturn to chapter overviewNext page

 

Description

 

Searches for a list-view item that has the specified properties and bears the specified relationship to a specified item.

 

Syntax

 

n = ListView_GetNextItem(hWnd, ctrlID, iStart, Flags)

 

Returns

 

Number

 

Parameters

 

Name

Type

Optional

Meaning

hWnd

Number

No

Handle of the dialog containing the list-view control

ctrlID

Number

No

Control identifier assigned to the control during CONTROL ADD ...

iStart

Number

No

The index of the item with which to begin the search, or -1 to find the first item that matches the specified flags.

Flags

Number

No

Specifies the relationship to the item specified in iStart. This can be one or a combination of the following values:

 

Searches by index.

%LVNI_ALL

%LVNI_PREVIOUS

%LVNI_ABOVE

%LVNI_BELOW

%LVNI_TOLEFT

%LVNI_TORIGHT

%LVNI_DIRECTIONMASK

%LVNI_CUT

%LVNI_DROPHILITED

%LVNI_FOCUSED

%LVNI_SELECTED

%LVNI_STATEMASK

 

Searches by appearance of items or by group

%LVNI_VISIBLEORDER

%LVNI_VISIBLEONLY

%LVNI_SAMEGROUPONLY

 

If an item does not have all of the specified state flags set, the search continues with the next item.

 

For more detailed info, see MSDN documentation at: http://msdn2.microsoft.com/en-us/library/bb761057(VS.85).aspx

 

Remarks

 

Restrictions

 

See also

 

Examples