Share via


CPagerCtrl Class

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

See Also

Reference

CPagerCtrl Class

Hierarchy Chart

Pager Controls