ScrollView control
[Standard controls]

Data Structures

• struct _CONTAINERINFO
• struct _svitem_operations
• struct _SCROLLVIEWITEMINFO

Modules

• Styles of scrollview control
• Messages of scrollview control
• Notification codes of scrollview control

Defines

• #define CTRL_SCROLLVIEW   ("scrollview")

  The class name of scrollview control, uses this name to create a scrollable window that consists of items.
  

• #define CTRL_SCROLLWND   ("scrollwnd")

  The class name of scrollwnd control, uses this name to create a scrollable window to which you can add controls.
  

Typedefs

• typedef GHANDLE HSVITEM
• typedef struct _CONTAINERINFO CONTAINERINFO
• typedef CONTAINERINFO * PCONTAINERINFO
• typedef int(* SVITEM_INITFUNC )(HWND hWnd, HSVITEM hsvi)

  Type of the scrollview item initialization callback procedure.
  

• typedef void(* SVITEM_DESTROYFUNC )(HWND hWnd, HSVITEM hsvi)

  Type of the scrollview item destroy callback procedure.
  

• typedef void(* SVITEM_DRAWFUNC )(HWND hWnd, HSVITEM hsvi, HDC hdc, RECT *rcDraw)

  Type of the scrollview item drawing callback procedure.
  

• typedef int(* SVITEM_CMP )(HSVITEM hsvi1, HSVITEM hsvi2)

  Type of the scrollview item compare function.
  

• typedef struct _svitem_operations SVITEMOPS
• typedef SVITEMOPS * PSVITEMOPS
• typedef struct _SCROLLVIEWITEMINFO SVITEMINFO
• typedef SVITEMINFO * PSVITEMINFO

Functions

• MG_EXPORT int GUIAPI DefaultContainerProc (HWND hWnd, int message, WPARAM wParam, LPARAM lParam)
• MG_EXPORT DWORD mglist_get_item_adddata (GHANDLE hi)

  Use this to get additional data from a list item in a control, such as scrollview and iconview.
  

• MG_EXPORT DWORD scrollview_get_item_adddata (HSVITEM hsvi)

  Use this to get additional data from scrollview item.
  

• MG_EXPORT int scrollview_get_item_index (HWND hWnd, HSVITEM hsvi)

  To get item index.
  

• MG_EXPORT BOOL scrollview_is_item_hilight (HWND hWnd, HSVITEM hsvi)

  To decide whether an item is the current hilighted item.
  

• MG_EXPORT BOOL scrollview_is_item_selected (HSVITEM hsvi)

  To decide whether an item is a selected.
  

• MG_EXPORT int scrollview_set_item_height (HWND hWnd, HSVITEM hsvi, int height)

  Sets the height of an item.
  

---

Detailed Description

Scrollview control is a scrollable window, which has a visible area and normally a larger content area, user can browse content area using scrollbar. Contents of the content area is totally user-defined, you can add controls in it, add customed listed items, or anything you want.

In fact, you can build a control needing scrolled window support on scrollview.

---

Define Documentation

#define CTRL_SCROLLVIEW   ("scrollview")

The class name of scrollview control, uses this name to create a scrollable window that consists of items.

Definition at line 60 of file scrollview.h.

#define CTRL_SCROLLWND   ("scrollwnd")

The class name of scrollwnd control, uses this name to create a scrollable window to which you can add controls.

Definition at line 68 of file scrollview.h.

---

Typedef Documentation

typedef struct _CONTAINERINFO CONTAINERINFO

Structure which defines a container.

typedef GHANDLE HSVITEM

Scrollview item object, use this handle to access a scrollview item

Definition at line 76 of file scrollview.h.

typedef CONTAINERINFO* PCONTAINERINFO

Data type of pointer to a CONTAINERINFO

Definition at line 98 of file scrollview.h.

typedef SVITEMINFO* PSVITEMINFO

Data type of pointer to a SVITEMINFO

Definition at line 198 of file scrollview.h.

typedef SVITEMOPS* PSVITEMOPS

Data type of pointer to a SVITEMOPS

Definition at line 185 of file scrollview.h.

typedef int(* SVITEM_CMP)(HSVITEM hsvi1, HSVITEM hsvi2)

Type of the scrollview item compare function.

Definition at line 172 of file scrollview.h.

typedef void(* SVITEM_DESTROYFUNC)(HWND hWnd, HSVITEM hsvi)

Type of the scrollview item destroy callback procedure.

Parameters:

	hWnd	Handle of the scrollview control .
	hsvi	Scrollview item handle.

Definition at line 155 of file scrollview.h.

typedef void(* SVITEM_DRAWFUNC)(HWND hWnd, HSVITEM hsvi, HDC hdc, RECT *rcDraw)

Type of the scrollview item drawing callback procedure.

Parameters:

	hWnd	Handle of the scrollview control.
	hsvi	Scrollview item handle.
	hdc	Drawing device context.
	rcDraw	Drawing rect area.

Definition at line 166 of file scrollview.h.

typedef void(* SVITEM_INITFUNC)(HWND hWnd, HSVITEM hsvi)

Type of the scrollview item initialization callback procedure.

Parameters:

	hWnd	Handle of the scrollview control .
	hsvi	Scrollview item handle.

Returns:

Zero on success; otherwise -1.

Definition at line 146 of file scrollview.h.

typedef struct _SCROLLVIEWITEMINFO SVITEMINFO

Structure of the scrollview item info

typedef struct _svitem_operations SVITEMOPS

Structure of item operations

---

Function Documentation

MG_EXPORT int GUIAPI DefaultContainerProc	(	HWND	hWnd,
		int	message,
		WPARAM	wParam,
		LPARAM	lParam
	)

Default container window procedure

See also:

DefaultDialogProc

DWORD mglist_get_item_adddata

(

GHANDLE

hi

)

Use this to get additional data from a list item in a control, such as scrollview and iconview.

DWORD scrollview_get_item_adddata

(

HSVITEM

hsvi

)

Use this to get additional data from scrollview item.

int scrollview_get_item_index	(	HWND	hWnd,
		HSVITEM	hsvi
	)

To get item index.

int scrollview_is_item_hilight	(	HWND	hWnd,
		HSVITEM	hsvi
	)

To decide whether an item is the current hilighted item.

int scrollview_is_item_selected

(

HSVITEM

hsvi

)

To decide whether an item is a selected.

int scrollview_set_item_height	(	HWND	hWnd,
		HSVITEM	hsvi,
		int	height
	)

Sets the height of an item.