CPagerCtrl Class

Article
01/08/2013

The CPagerCtrl class wraps the Windows pager control, which can scroll into view a contained window that does not fit the containing window.

class CPagerCtrl : public CWnd

Members

Public Constructors

Name	Description
CPagerCtrl::CPagerCtrl	Constructs a CPagerCtrl object.

Public Methods

Name	Description
CPagerCtrl::Create	Creates a pager control with specified styles and attaches it to the current CPagerCtrl object.
CPagerCtrl::CreateEx	Creates a pager control with specified extended styles and attaches it to the current CPagerCtrl object.
CPagerCtrl::ForwardMouse	Enables or disables forwarding WM_MOUSEMOVE messages to the window that is contained in the current pager control.
CPagerCtrl::GetBkColor	Retrieves the background color of the current pager control.
CPagerCtrl::GetBorder	Retrieves the border size of the current pager control.
CPagerCtrl::GetButtonSize	Retrieves the button size of the current pager control.
CPagerCtrl::GetButtonState	Retrieves the state of the specified button in the current pager control.
CPagerCtrl::GetDropTarget	Retrieves the IDropTarget interface for the current pager control.
CPagerCtrl::GetScrollPos	Retrieves the scroll position of the current pager control.
CPagerCtrl::IsButtonDepressed	Indicates whether the specified button of the current pager control is in pressed state.
CPagerCtrl::IsButtonGrayed	Indicates whether the specified button of the current pager control is in grayed state.
CPagerCtrl::IsButtonHot	Indicates whether the specified button of the current pager control is in hot state.
CPagerCtrl::IsButtonInvisible	Indicates whether the specified button of the current pager control is in invisible state.
CPagerCtrl::IsButtonNormal	Indicates whether the specified button of the current pager control is in normal state.
CPagerCtrl::RecalcSize	Causes the current pager control to recalculate the size of the contained window.
CPagerCtrl::SetBkColor	Sets the background color of the current pager control.
CPagerCtrl::SetBorder	Sets the border size of the current pager control.
CPagerCtrl::SetButtonSize	Sets the button size of the current pager control.
CPagerCtrl::SetChild	Sets the contained window for the current pager control.
CPagerCtrl::SetScrollPos	Sets the scroll position of the current pager control.

Remarks

A pager control is a window that contains another window that is linear and larger than the containing window, and enables you to scroll the contained window into view. The pager control displays two scroll buttons that automatically disappear when the contained window is scrolled to its farthest extent, and reappear otherwise. You can create a pager control that scrolls either horizontally or vertically.

For example, if your application has a toolbar that is not wide enough to show all of its items, you can assign the toolbar to a pager control and users will be able to scroll the toolbar to the left or right to access all of the items. Microsoft Internet Explorer Version 4.0 (commctrl.dll version 4.71) introduces the pager control.

The CPagerCtrl class is derived from the CWnd class. For more information and an illustration of a pager control, see Pager Controls.

Inheritance Hierarchy

CObject

CCmdTarget

CWnd

CPagerCtrl

Requirements

Header: afxcmn.h