Click here to Skip to main content
15,867,308 members
Articles / Desktop Programming / MFC

Implementing Rulers Inside of Splitter Panes

Rate me:
Please Sign up or sign in to vote.
4.29/5 (8 votes)
4 Jan 2000 110.6K   2.3K   37   11
Using fixed panes to add rulers to your view

Sample Image - rulers.jpg

Introduction

Many applications that display images or documents show rulers on both sides of the view to indicate your position within the page and allow a more accurate positioning of the cursor. Implementing rulers can be difficult, since we must reserve a space for them inside the view (this gets more difficult on a CScrollView-derived class). Another solution is to use "fixed" splitters (meaning they cannot be resized). The example below demonstrates how to build such rulers.

The Code

The code implementing the ruler splitter window and views used for the rulers themselves can be found in ruler.h and ruler.cpp. Below is a sample of how to use them.

Inside the frame window (which can be either a CFrameWnd or CMDIChildWnd-derived class):

C++
// class definition
class
 CMainFrame : public
 CFrameWnd
{
[...]
protected
:
    DECLARE_FX_RULER(CMainFrame)

The next step is to create the splitter itself and the views. The code below matches a SDI application that accommodates the code above inside a splitter pane, but you can easily adjust it to fit your needs. In the OnCreateClient member of the CMainFrame class, add code to create the splitter inside the right pane:

C++
// class definition

IMPLEMENT_FX_RULER_SPLITTER(<className>, 
  <parentSplitter>, 0, 1, pContext->m_pNewViewClass);

What you have to do next is send notifications to the rulers to let them know about the scroll position change or zoom change. The rulers can also display the mouse position as the cursor moves; this is done also by sending notifications to the rulers with just a few lines of code like:

C++
// class definition

GetDocument()->UpdateAllViews(this, 
  VW_VSCROLL, (CObject*)(GetScrollPosition().y));

Available hint types are (hint parameters are passed as INTs using a cast to CObject*):

VW_HSCROLL View is scrolled horizontally
VW_VSCROLL View is scrolled vertically
VW_HPOSITION Cursor position changed on the x axis
VW_VPOSITION Cursor position changed on the y axis

The code is quite easy to follow and change to meet your needs, but if you need assistance, please leave a note in the comments section below. Also please send me bugs or updates, to keep this solution up-to-date. For more details on the sample application, contact me via the comments section below.

License

This article has no explicit license attached to it, but may contain usage terms in the article text or the download files themselves. If in doubt, please contact the author via the discussion board below.

A list of licenses authors might use can be found here.


Written By
Web Developer
Romania Romania
... coming in a short while

Comments and Discussions

 
QuestionpDoc Null in consequence of OnMouseActivate Pin
Member 568844321-Jan-15 5:25
Member 568844321-Jan-15 5:25 
Generaluse GetSysColorBrush instead of CreateSolidBrush Pin
RedFraggle13-Jun-09 9:41
RedFraggle13-Jun-09 9:41 
Questionimplementation ? Pin
Ken Keray16-Sep-03 7:35
Ken Keray16-Sep-03 7:35 
AnswerRe: implementation ? Pin
NoSpam!16-Feb-04 8:19
NoSpam!16-Feb-04 8:19 
GeneralRe: implementation ? Pin
Ken Keray17-Feb-04 11:31
Ken Keray17-Feb-04 11:31 
Questionhow does it work in MM_A mode Pin
JQEang25-May-03 19:46
JQEang25-May-03 19:46 
GeneralOh, the code finally appeals! Pin
TeleStar22-Dec-02 20:38
TeleStar22-Dec-02 20:38 
QuestionGetting this Damm thing to work? Pin
29-Nov-00 23:39
suss29-Nov-00 23:39 
AnswerRe: Getting this Damm thing to work? Pin
7-Jul-01 10:54
suss7-Jul-01 10:54 
GeneralNeeds Better Docs and a sample Pin
Anonymous13-Apr-00 4:57
Anonymous13-Apr-00 4:57 
GeneralRe: Needs Better Docs and a sample Pin
eljkmw17-Sep-00 16:42
eljkmw17-Sep-00 16:42 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.