Edit

Share via

ListView_EnsureVisible macro (commctrl.h)

  • Article

Ensures that a list-view item is either entirely or partially visible, scrolling the list-view control if necessary. You can use this macro or send the LVM_ENSUREVISIBLE message explicitly.

Syntax

BOOL ListView_EnsureVisible(
   HWND hwndLV,
   int  i,
   BOOL fPartialOK
);

Parameters

hwndLV

Type: HWND

A handle to the list-view control.

i

Type: int

The index of the list-view item.

fPartialOK

Type: BOOL

A value specifying whether the item must be entirely visible. If this parameter is TRUE, no scrolling occurs if the item is at least partially visible.

Return value

Type: BOOL

Returns TRUE if successful, or FALSE otherwise.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header commctrl.h