The new vbAccelerator Site - more VB and .NET Code and Controls
Source Code
2 Common Controls Library &nbsp
A Pager Control

A control container which will automatically enable scrolling for its child control

&nbsp

[Pager Control]

UpdateUpdated 25 October 1998. I added the hWnd and PagerhWnd properties to the control so you can add a pager control to a vbAccelerator Toolbar and Rebar control. See Using the Toolbar with the Pager control for a demonstration.

Introduction
The pager control is a new Common Control supplied as part of COMCTL32.DLL v4.72. This DLL is shipped with Internet Explorer 4.0, but can also be downloaded separately from the Microsoft site. (Note you must register with MSDN to follow this link, but it is free). These projects include a full implementation of the Pager control for VB applications.

Download the Pager Control with source (31kb)

Your license to the code - what you can do

Download a Pager Control test project, where the control is compiled into the EXE (140kb)


These samples require the SSubTmr.DLL component. Make sure you have loaded and registered this before trying either project.

What is a Pager Control?
The Pager Control is useful in situations where a window does not have enough area to display a child window. 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 to the left or right to access all of the items. You can also create pager controls that scroll vertically.

The following illustration shows a toolbar contained in a pager control. The areas coloured in red are the Pager control parts:



How to Use the Pager Control
The Pager Control has been implemented as a control container. In order for the pager to scroll another control, it must be a child of the Pager Control. You can do this either by drawing the control to be scrolled into the pager control at design-time, or by setting the child control's Container property at run-time.

To initialise the pager for the child control, first set the desired orientation with the Orientation property. Then call the AddChildWindow method with the hWnd of the control you want to scroll. If the control is a VB toolbar, the buttons will automatically be set to flat ones.

The control will respond to AddChildWindow with a RequestSize event, during which you should fill in the width or height (dependent on orientation) in pixels of the child control. If you subsequently change the size of the child control, call the RecalcSize method, which will again fire the RequestSize event.

Whenever scrolling occurs, the control fires the Scroll event with the amount it proposes to scroll by in pixels. You can change this amount to your own preferred setting or return 0 to prevent scrolling.

Additional properties let you query the state of the control and set its appearance:

  • AutoHScroll Determines whether the control will automatically scroll during drag-drop operations (DragDrop should be set to true).
  • BackColor Lets you set the back colour of the pager.
  • BorderStyle Sets whether the control has a 3d border or none.
  • ButtonSize Allows you to modify the size of the pager's buttons.
  • ButtonState Returns whether a button is pressed or not.
  • DragDrop Sets whether the control acts as a drag drop target.
  • InternalBorderWidth sets the border between the pager's edges and the control.

Enjoy!



TopBack to top
Source Code - What We're About!Back to Source Code

&nbsp

AboutContributeSend FeedbackPrivacy

Copyright 1998-1999, Steve McMahon ( steve@vbaccelerator.com). All Rights Reserved.
Last updated: 15 August 1999