CCamView Class Reference

This OIL class implements many window functions, such as scrolling and sizing the editing windows. As such, it acts as an intermediary between the kernel and the host operating system. It is derived from the wx class wxView, which provides comprehensive methods for managing the client area of a window. More...

#include <camview.h>

Inheritance diagram for CCamView:

List of all members.

Public Member Functions
	CCamView ()
	Default constructor for a CCamView window. Sets the pointers to the child windows to null, so that an incomplete construction of the view that is later destroyed won't try to delete invalid pointers. The Windows side of construction is done later, in the OnCreate() message handler.
virtual	~CCamView ()
	Destroys a CCamView window. Deletes child windows first. Updates the CCamView population counter.
virtual bool	OnCreate (wxDocument *doc, long flags)
bool	OnClose (bool deleteWindow=TRUE)
wxMDIChildFrame *	GetParentFrame () const
CCamDoc *	GetDocument () const
ViewState *	GetViewState () const
ViewState *	SetViewState (ViewState *pvs)
void	SetViewStateFromThis () const
void	SetThisFromViewState ()
BOOL	IsTopmost () const
	Tests if this ScreenView is the active view, ie. is on top of all other views.
virtual CNativeDC *	GetRenderDC () const
virtual void	AllocateDC () const
virtual void	DoneWithDC () const
void	GetClientSize (int *width, int *height) const
virtual void	OnDraw (wxDC *pDc)
virtual BOOL	OnPreparePrinting (CCPrintInfo *pInfo)
virtual void	OnFilePrint ()
virtual void	OnFilePrintPreview ()
CRenderWnd *	GetRenderWindow () const
void	InvalidateView (const OilRect *pRect=0, BOOL updatenow=FALSE)
void	OnSize (wxSizeEvent &event)
	Resizes and repositions all child windows to fit the new size of the ScreenView. Updates the ViewState object with the size and position of the view, in an OS-independent manner. Resets the scroller's page and line size, and forces an immediate redraw of all affected windows.
void	OnLButtonDown (wxMouseEvent &event)
	Called by MFC upon receipt of a left-button-down mouse message. Finds out which other buttons are down (eg. SHIFT) and passes the message on to the kernel. Note that the mouse message will have originally come from the RendWnd object, a child window of ScreenView.
void	OnLButtonDblClk (wxMouseEvent &event)
	Passes a left-button double-click to CCamView::HandleDragEvent().
void	OnLButtonUp (wxMouseEvent &event)
	Passes the event on to HandleButtonUp().
void	OnMButtonDown (wxMouseEvent &event)
	Called by MFC upon receipt of a middle-button-down mouse message. Finds out which other buttons are down (eg. SHIFT) and passes the message on to the kernel. Note that the mouse message will have originally come from the RendWnd object, a child window of ScreenView.
void	OnMButtonDblClk (wxMouseEvent &event)
	Passes a middle-button double-click to CCamView::HandleDragEvent().
void	OnMButtonUp (wxMouseEvent &event)
	Passes the event on to HandleButtonUp().
void	OnRButtonDown (wxMouseEvent &event)
	Same as for CCamView::OnLButtonDown(), but for the right mouse button.
void	OnRButtonDblClk (wxMouseEvent &event)
	Same as CCamView::OnLButtonDblClk(), bit for the right button.
void	OnRButtonUp (wxMouseEvent &event)
	Same as CCamView::OnLButtonUp(), but for the right mouse button.
void	OnMouseMove (wxMouseEvent &event)
	Packages up OIL-layer mouse-move messages before passing them on to DocView::DragPointerMove(). If ScreenView is not in "drag mode" the event is passed to our DocView, which will forward it to the current tool. Otherwise, checks if a CLICKTYPE_DRAG message has been sent to the kernel, sending one if it hasn't (this smooths the difference between Windows and RISC OS, the former system providing little support for drag operations).
void	OnMouseWheel (wxMouseEvent &event)
	Scope: Protected.
void	OnScroll (wxScrollEvent &event)
	Handles all the scroll events.
void	OnDragIdle (wxTimerEvent &event)
	Sends DragPointerIdle "events" to the kernel, when dragging. As Windows doesn't support such "idle" messages, the OIL drag system sets up a timer when a drag starts, and sends idle messages every time the timer elapses, until the drag is finished.
void	OnSetCursor (wxSetCursorEvent &event)
	Eat the cursor update requests to stop anyone else playing with them, this is needed on MSW or the cursor reverts to the normal arrow.
bool	OnDropFiles (wxCoord x, wxCoord y, const wxArrayString &filenames)
void	SetWorkAreaExtent (const WorkRect &area, BOOL redraw=TRUE)
void	GetScrollOffset (WorkCoord *pOffset) const
void	SetScrollOffset (const WorkCoord &pos, BOOL redraw=TRUE)
void	ShowScrollers (BOOL Show)
void	ShowRulers (BOOL Show)
WorkRect	GetMaxScrollRect () const
	Find the legal area in which scroll offsets can exist.
BOOL	AreRulersVisible ()
BOOL	AreScrollersVisible ()
MouseOverRulerHit	IsMouseOverRuler ()
void	RecaptureMouseOnNextUpdate (void)
BOOL	StartDrag (Operation *pOp, DragType type, BOOL KeepAccuracy)
BOOL	EndDrag (Operation *pOp)
BOOL	ChangeDragType (DragType Type)
	Allows someone to change the type of a drag (eg have Auto Scrolling on in some situations, but not in others). This function is mostly called from the Kernel (DocView) version of the same function.
void	ClearClickState ()
BOOL	InvokeDragOp (String_256 *pOpToken, OpParam *pParam, UINT32 Flags, wxPoint point)
	This func provides a mechanism that allows a drag op to be invoked as if it has been started as a result of clicking in the view. This allows drag ops to be invoked that aren't associated to a given tool.
BOOL	InvokeDragOp (String_256 *pOpToken, OpParam *pParam, ClickModifiers clickmods, wxPoint point)
BOOL	IsWaitingMouseMove ()
BOOL	GetCurrentMousePos (OilCoord *pMousePos) const
BOOL	CreateDragTarget (DragInformation *DragInfo)
	will create drag targets for appropriate drags
DocView *	GetDocViewPtr () const
BOOL	IsSingleClickReallyTriple () const
BOOL	IsSingleClickReallyQuad () const
void	DontSkipNextMouse ()
Static Public Member Functions
static BOOL	ReadViewPrefs ()
static DocView *	GetDocViewFromWindow (wxWindow *pWindow)
	Given a window handle of a ScreenView render window, this function will return a pointer to the kernel DocView object that renders into that window, or NULL if there isn't one.
static void	SetUseVisibleDefaults (BOOL state)
static BOOL	GetUseVisibleDefaults ()
static BOOL	GetDefaultRulersState ()
static BOOL	GetDefaultScrollersState ()
static void	SetDefaultRulersState (BOOL State)
static void	SetDefaultScrollersState (BOOL State)
static void	GetClickMods (wxMouseEvent &event, ClickModifiers *p)
	Helps convert an OIL-layer mouse event into a form acceptable to the kernel. Sets the fields of the ClickModifier according to which button is down/up, whether the SHIFT, CONTROL, or ALT key is held down etc. Note that as the fields of a ClickModifier are only one bit wide, we must be carefule when assigning the (integer) results of logical tests to them.
static DocView *	GetDocViewFromWindowID (CWindowID WindowID)
	Given a window handle of a ScreenView render window, this function will return a pointer to the kernel DocView object that renders into that window, or NULL if there isn't one.
Static Public Attributes
static INT32	s_MouseMoveEliminationPeriod
Protected Member Functions
void	GrabKernelAttention () const
void	SetCurrentStates ()
virtual BOOL	CreateNewDocView ()
virtual BOOL	IsARalphView ()
LRESULT	OnRenderView (WPARAM wp, LPARAM lp)
void	ScrollTo (const WorkCoord &offset)
	Scroll the client area of the window to the specified position. The offset must be converted to OS coordinates before being passed to Windows. If the new position of the view does not overlap the old position then the client area is completely redrawn. Otherwise, the Windows USER module is called to scroll the window.
void	ScrollBy (INT32 dx, INT32 dy)
	Scrolls the view by asking the DocView to do it so it can remove and replace blobs.
void	HandleDragEvent (UINT32 Button, UINT32 nFlags, wxPoint point, ClickType t)
	Gathers together Windows information about a mouse event and passes it on to the kernel, by calling DocView::OnClick() HandleDragEvent needs to be called from OnTimer code so rather than synthesizing a wxMouseEvent object this function has been left taking non-wx params.
void	HandleDragEvent (UINT32 Button, ClickModifiers clickmods, wxPoint point, ClickType t)
BOOL	HandleMouseWheelEvent (wxMouseEvent &event)
void	HandleDragScrolling (wxPoint point)
	Checks if the view window needs to be scrolled because the cursor has been dragged outside the window. The window will be scrolled if the current mode is AUTO_SCROLL (and the Scroll Lock key isn't latched!!). The scrolling itself is done by calling the routine in DocView, not ScreenView, so that the kernel has fair warning to remove any blobbies before the blit is done.
void	CalcScrollDeltas (wxPoint point, WinRect wrSize, INT32 *dx, INT32 *dy)
	Calculates the scroll deltas due to the current mouse position being outside the allowed rectangle. Helper function.
void	HandleButtonUp (UINT32 Button, wxMouseEvent &event)
	Finishes the current drag, if there is one, by elucidating the state of the buttons etc and calling DragDFinished() in the kernel (DocView). Called whenever a mouse button is released.
BOOL	PrintPaper (wxDC *pPrintDC, CCPrintInfo *pPrintInfo, PrintControl *pPrintControl)
WinRect	GetPrintClipRect (wxDC *pPrintDC, CCPrintInfo *pPrintInfo)
void	EnumeratePagePatches (CCPrintInfo *pPrintInfo)
void	UpdateViewPosition () const
virtual void	OnInitialUpdate ()
virtual void	OnUpdate (wxView *sender, wxObject *hint=(wxObject *) NULL)
virtual void	OnActivateView (bool bActivate, wxView *pActiveView, wxView *pDeactiveView)
Static Protected Member Functions
static void	wxPoint2Coord (const wxPoint &point, Coord *pcoord)
	Converts a wxPoint to a kernel Coord.
static void	Coord2wxPoint (const Coord &coord, wxPoint *ppoint)
	Converts a kernel Coord to a wxPoint.
static void	wxRect2Rect (const wxRect &rect, Rect *pkrect)
	Converts a wxRect into a kernel Rect.
static void	Rect2wxRect (const Rect &krect, wxRect *prect)
	Converts a kernel Rect into a wxRect.
Protected Attributes
wxMDIChildFrame *	m_pFrame
CRenderWnd *	RenderWindow
CWinScroller *	HScrollBar
CWinScroller *	VScrollBar
CScrollerCorner *	Corner
OILHorizontalRuler *	HRuler
OILVerticalRuler *	VRuler
OriginGadget *	OGadget
DocView *	pDocView
PrintView *	pPrintView
ViewState *	Status
BOOL	fSetupDone
BOOL	fInitialUpdate
BOOL	fJustCreated
WinRect	CurrentSize
WorkRect	WorkArea
WorkCoord	OldOffset
String_256	DragOpToken
OpParam *	pDragOpParam
BOOL	DragOpInvoke
MonotonicTime	TimeOfLastClick
wxPoint	LastDoubleClickPos
BOOL	ThisSingleIsTriple
BOOL	ThisDoubleIsQuad
wxTimer	m_DragIdleTimer
MonotonicTime	m_OLELastOutTime
BOOL	DragKeepAccuracy
BOOL	AutoScrollExcludeRulers
ClickType	LastClickType
UINT32	LastClickButton
wxPoint	LastClickPoint
wxPoint	CurrentMousePos
ClickModifiers	LastClickMods
UINT32	FirstClickButton
Operation *	pCurrentDragOp
DragType	CurrentDragType
WinRect	MouseClipRect
BOOL	OLERecaptureMouse
INT32	m_LastMouseState
wxPoint	m_LastMousePosition
INT32	m_LastMouseUsedTimestamp
BOOL	m_CouldSkipNextMouse
Static Protected Attributes
static const INT32	WID_RENDERWINDOW = 1
static const INT32	WID_HSCROLLBAR = 2
static const INT32	WID_VSCROLLBAR = 3
static const INT32	WID_SIZECORNER = 4
static const INT32	WID_HRULER = 5
static const INT32	WID_VRULER = 6
static const INT32	WID_RULERORIGIN = 7
static const INT32	DragIdleID = 100
static INT32	PopCount
static ViewState *	pReadyMadeViewState
static BOOL	DefaultScrollersState
static BOOL	DefaultRulersState
static BOOL	UseVisibleDefaults
static INT32	DragLatency
static INT32	DragDelay
static MonotonicTime	DragTimer
static INT32	ScrollBarSize

---

Detailed Description

This OIL class implements many window functions, such as scrolling and sizing the editing windows. As such, it acts as an intermediary between the kernel and the host operating system. It is derived from the wx class wxView, which provides comprehensive methods for managing the client area of a window.

Author:

Luke_Hart (Xara Group Ltd) <camelotdev@xara.com> H

Date:

01/07/05

On creation, a CCamView asks its Document to provide a pointer to the DocView that is to be associated with this object. Once that link has been made, any changes in the state of the CCamView, eg. the user maximises it, are passed on in a device-independent form to the DocView. This trick is done using a shared ViewState object.

Definition at line 157 of file camview.h.

---

Constructor & Destructor Documentation

CCamView::CCamView (   )

Default constructor for a CCamView window. Sets the pointers to the child windows to null, so that an incomplete construction of the view that is later destroyed won't try to delete invalid pointers. The Windows side of construction is done later, in the OnCreate() message handler. / IMPLEMENT_DYNAMIC_CLASS( CCamView, wxView ) CC_IMPLEMENT_DYNAMIC( ViewDragTarget, OilDragTarget ) CC_IMPLEMENT_DYNCREATE( PageDropInfo, CCObject ) Declare smart memory handling in Debug builds define new CAM_DEBUG_NEW This user preference controls how many pixels the mouse must move before a drag is initiated. INT32 CCamView::DragLatency = 3; INT32 CCamView::s_MouseMoveEliminationPeriod = 0; Used to start drags after user has clicked but not moved mouse for n milliseconds. INT32 CCamView::DragDelay = 500; MonotonicTime CCamView::DragTimer; INT32 CCamView::PopCount = 0; ViewState* CCamView::pReadyMadeViewState = NULL; BOOL CCamView::DefaultScrollersState = TRUE; BOOL CCamView::DefaultRulersState = FALSE; BOOL CCamView::UseVisibleDefaults = TRUE; Default to a nonsense size. Will be fixed up in OnSize INT32 CCamView::ScrollBarSize = 1; BEGIN_EVENT_TABLE( CCamView, wxView ) EVT_SIZE(CCamView::OnSize) EVT_SCROLL(CCamView::OnScroll) EVT_TIMER(DragIdleID, CCamView::OnDragIdle) END_EVENT_TABLE() /*! Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Updates the CCamView population counter. Called from somewhere deep inside MFC. Returns: Errors: - Scope: Protected. See also: CCamView::OnCreate(); CCamView::~CCamView() Definition at line 189 of file camview.cpp. { TRACEUSER("Gerry", _T("Creating CCamView at 0x%08x\n"), this); // No child windows or connections yet. pDocView = NULL; pPrintView = NULL; // Create a ViewState object to maintain device-independent information. Status = new ViewState; RenderWindow = NULL; HScrollBar = NULL; VScrollBar = NULL; Corner = NULL; HRuler = NULL; VRuler = NULL; OGadget= NULL; // Set/clear these internal flags. fSetupDone = FALSE; fInitialUpdate = FALSE; // Not dragging or scrolling either. pCurrentDragOp = NULL; OLERecaptureMouse = FALSE; // Set up click event variables LastClickType = CLICKTYPE_NONE; LastClickButton = 0; LastClickPoint.x = 0; LastClickPoint.y = 0; CurrentMousePos.x = 0; CurrentMousePos.y = 0; FirstClickButton = 0; DragKeepAccuracy = TRUE; AutoScrollExcludeRulers = FALSE; // Bump the population. PopCount++; // Vars used by InvokeDragOp() mechanism DragOpToken = ""; pDragOpParam = NULL; DragOpInvoke = FALSE; // Set up the drag idle timer m_DragIdleTimer.SetOwner(this, DragIdleID); // Triple and quad click support LastDoubleClickPos = wxPoint( 0, 0 ); ThisSingleIsTriple = FALSE; ThisDoubleIsQuad = FALSE; // Set this flag until we have been through OnActivateView once, after which we can // include this view in the eat-activating-click system. fJustCreated = TRUE; // Mouse move handling m_LastMouseState=0; m_LastMousePosition=wxDefaultPosition; m_LastMouseUsedTimestamp=0; m_CouldSkipNextMouse=FALSE; OldOffset = WorkCoord(0, 0); // need to initialize it to something }

CCamView::~CCamView (   )  [virtual]

Destroys a CCamView window. Deletes child windows first. Updates the CCamView population counter. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Public See also: CCamView::CCamView() Definition at line 273 of file camview.cpp. { TRACEUSER("Gerry", _T("Deleting CCamView at 0x%08x\n"), this); PopCount--; // one less ScreenView in the world, sigh if(pDocView != NULL) delete pDocView; if(Status != NULL) delete Status; pDocView = NULL; Status = NULL; // We shouldn't have a print view here! if (pPrintView != NULL) { ERROR3("CCamView is dying when it still has a PrintView attached!"); delete pPrintView; } }

---

Member Function Documentation

virtual void CCamView::AllocateDC (   )  const [virtual]

BOOL CCamView::AreRulersVisible (   )

Reimplemented in ScreenView.

BOOL CCamView::AreScrollersVisible (   )

Author: Chris_Snook (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: Scroller Visible state. Errors: - Scope: Public Reimplemented in ScreenView. Definition at line 2793 of file camview.cpp. { if(Status) return Status->ScrollersVisible; return FALSE; }

void CCamView::CalcScrollDeltas (  wxPoint  point, WinRect  wrSize, INT32 *  dx, INT32 *  dy )  [protected]

Calculates the scroll deltas due to the current mouse position being outside the allowed rectangle. Helper function. Author: Phil_Martin (Xara Group Ltd) <camelotdev@xara.com> (from Justin) Date: 22/9/96 Parameters: point  The current position of the mouse cursor. [INPUTS] wrSize The rectangle controlling scrolling. dx  The amount to scroll in the X axis. [OUTPUTS] dy The amount to scroll in the Y axis. Returns: - Errors: - Scope: Protected See also: CCamView::HandleDragScrolling Reimplemented in ScreenView. Definition at line 4908 of file camview.cpp. { if( point.x < wrSize.GetLeft() ) *dx = max(point.x - wrSize.GetLeft(), -ScrollBarSize); else if( point.x >= wrSize.GetRight() ) *dx = min(point.x - wrSize.GetRight(), ScrollBarSize); else *dx = 0; if( point.y < wrSize.GetTop() ) *dy = max(point.y - wrSize.GetTop(), -ScrollBarSize); else if( point.y >= wrSize.GetBottom() ) *dy = min(point.y - wrSize.GetBottom(), ScrollBarSize); else *dy = 0; }

BOOL CCamView::ChangeDragType (  DragType  Type  )

Allows someone to change the type of a drag (eg have Auto Scrolling on in some situations, but not in others). This function is mostly called from the Kernel (DocView) version of the same function. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 3/4/95 Parameters: Type  - the type of drag to change to [INPUTS] Returns: TRUE See also: DocView::ChangeDragType Reimplemented in ScreenView. Definition at line 4723 of file camview.cpp. { // Change the current drag type CurrentDragType = Type; m_OLELastOutTime.Sample(); OLERecaptureMouse = FALSE; return TRUE; }

void CCamView::ClearClickState (   )

Reimplemented in ScreenView.

void CCamView::Coord2wxPoint (  const Coord &  coord, wxPoint *  ppoint )  [static, protected]

Converts a kernel Coord to a wxPoint. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 7/4/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: - Definition at line 4044 of file camview.cpp. { ppoint->x = (INT32) coord.x; ppoint->y = (INT32) coord.y; }

BOOL CCamView::CreateDragTarget (  DragInformation *  DragInfo  )

will create drag targets for appropriate drags Author: Chris_Parks (Xara Group Ltd) <camelotdev@xara.com> Date: 21/1/95 Parameters: DragInfo  : details about the current drag [INPUTS] -  [OUTPUTS] Returns: Errors: - Reimplemented in ScreenView. Definition at line 5107 of file camview.cpp. { #if !defined(EXCLUDE_FROM_RALPH) // TEMPORARY - only create drag targets for the selected (frontmost/input-focus) // DocView. This stops us allowing colour drags to go into the wrong document // if the user ctrl-tabs to a different window during the drag. // Ideally, drags will be allowed, but the colour will be copied to the destination // document before being applied, but currently we don't have time to implement all that if (pDocView != DocView::GetSelected()) return FALSE; if (DragInfo->CanDropOnPage()) { // If the drag can be dropped onto an object or the page, then we will accept it ViewDragTarget * NewTarget; NewTarget = new ViewDragTarget(RenderWindow,NULL,DragInfo); return TRUE; } #endif return FALSE; }

virtual BOOL CCamView::CreateNewDocView (   )  [protected, virtual]

virtual void CCamView::DoneWithDC (   )  const [virtual]

void CCamView::DontSkipNextMouse (   )  [inline]

Definition at line 409 of file camview.h. {m_CouldSkipNextMouse=FALSE;}

BOOL CCamView::EndDrag (  Operation *  pOp  )

Reimplemented in ScreenView.

void CCamView::EnumeratePagePatches (  CCPrintInfo *  pPrintInfo  )  [protected]

Reimplemented in ScreenView.

void CCamView::GetClickMods (  wxMouseEvent &  event, ClickModifiers *  p )  [static]

Helps convert an OIL-layer mouse event into a form acceptable to the kernel. Sets the fields of the ClickModifier according to which button is down/up, whether the SHIFT, CONTROL, or ALT key is held down etc. Note that as the fields of a ClickModifier are only one bit wide, we must be carefule when assigning the (integer) results of logical tests to them. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: The  mouse event passed by wx to a mouse message-handler function. [INPUTS] Changes  the ClickModifier to reflect the button flags. [OUTPUTS] Returns: - Errors: - Scope: Public See also: CCamView::HandleDragEvent() Reimplemented in ScreenView. Definition at line 4883 of file camview.cpp. { *p = ClickModifiers::GetClickModifiers(event); }

void CCamView::GetClientSize (  int *  width, int *  height )  const

Reimplemented in ScreenView.

BOOL CCamView::GetCurrentMousePos (  OilCoord *  pMousePos  )  const

Reimplemented in ScreenView.

static BOOL CCamView::GetDefaultRulersState (   )  [inline, static]

Reimplemented in ScreenView. Definition at line 271 of file camview.h. { return DefaultRulersState;};

static BOOL CCamView::GetDefaultScrollersState (   )  [inline, static]

Reimplemented in ScreenView. Definition at line 272 of file camview.h. { return DefaultScrollersState;};

CCamDoc* CCamView::GetDocument (   )  const

DocView * CCamView::GetDocViewFromWindow (  wxWindow *  pWindow  )  [static]

Given a window handle of a ScreenView render window, this function will return a pointer to the kernel DocView object that renders into that window, or NULL if there isn't one. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 28/7/94 Parameters: The  handle of the render window to find. [INPUTS] -  [OUTPUTS] Returns: A pointer to the DocView associated with a render window, or NULL if there isn't one. Errors: - See also: - Definition at line 5047 of file camview.cpp. { // For all kernel documents in existence . . . List* pDocList = &(GetApplication()->Documents); for (Document* pKernelDoc = (Document*) pDocList->GetHead(); pKernelDoc != NULL; pKernelDoc = (Document*) pDocList->GetNext(pKernelDoc)) { if (pKernelDoc->IsARalphDoc()) { // a bit unpleasent - only works because Ralph Docs have only one view.. // get the first (and only) docview DocView * pDocView = pKernelDoc->GetFirstDocView(); // check handles if (pDocView) if( pDocView->GetRenderWindow() == pWindow ) return pDocView; } else { // Convert from a kernel document to an OIL document. CCamDoc* pCamDoc = pKernelDoc->GetOilDoc(); wxNode *node = pCamDoc->GetViews().GetFirst(); while (node) { // Compare the handle of the view's render window to the given handle, // returning the associated DocView if they match. CCamView* pCamView = (CCamView*) node->GetData(); // Not interested unless it is a ScreenView (it could be a print preview view) // if (pCamView->IsKindOf(RUNTIME_CLASS(CCamView))) // { if (pCamView->GetRenderWindow() == pWindow) { return pCamView->pDocView; } // } node = node->GetNext(); } } } // Couldn't find the handle, so return nothing. return NULL; }

DocView * CCamView::GetDocViewFromWindowID (  CWindowID  WindowID  )  [static]

Given a window handle of a ScreenView render window, this function will return a pointer to the kernel DocView object that renders into that window, or NULL if there isn't one. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 28/7/94 Parameters: The  handle of the render window to find. [INPUTS] -  [OUTPUTS] Returns: A pointer to the DocView associated with a render window, or NULL if there isn't one. Errors: - See also: - Reimplemented in ScreenView. Definition at line 5146 of file camview.cpp. { // For all kernel documents in existence . . . List* pDocList = &(GetApplication()->Documents); for (Document* pKernelDoc = (Document*) pDocList->GetHead(); pKernelDoc != NULL; pKernelDoc = (Document*) pDocList->GetNext(pKernelDoc)) { DocView * pDocView = pKernelDoc->GetFirstDocView(); while (pDocView) { if ( pDocView->GetRenderWindow() == WindowID ) return pDocView; pDocView = pKernelDoc->GetNextDocView(pDocView); } } // Couldn't find the handle, so return nothing. return NULL; }

DocView* CCamView::GetDocViewPtr (   )  const [inline]

Reimplemented in ScreenView. Definition at line 317 of file camview.h. { return pDocView; }

WorkRect CCamView::GetMaxScrollRect (   )  const

Find the legal area in which scroll offsets can exist. Author: Phil_Martin (Xara Group Ltd) <camelotdev@xara.com> Date: 31/May/2006 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: WorkRect describing legal area for scroll offsets Errors: - See also: - Definition at line 4987 of file camview.cpp. { WorkRect wrScrollRect = Status->WorkAreaExtent; FIXED16 PixelWidth, PixelHeight; pDocView->GetPixelSize(&PixelWidth, &PixelHeight); WorkCoord WindowSize; WindowSize.x = CurrentSize.GetWidth() * PixelWidth; WindowSize.y = CurrentSize.GetHeight() * PixelHeight; if (WindowSize.x > wrScrollRect.hi.x) // If window wider than document wrScrollRect.hi.x = wrScrollRect.lo.x; // no horz scrolling is possible else wrScrollRect.hi.x -= WindowSize.x; // Restrict scrollable area to ensure view never sees outside workarea if (WindowSize.y < wrScrollRect.lo.y) // If window wider than document wrScrollRect.lo.y = wrScrollRect.hi.y; // no vert scrolling is possible else wrScrollRect.lo.y += WindowSize.y; // Restrict scrollable area to ensure view never sees outside workarea return wrScrollRect; }

wxMDIChildFrame* CCamView::GetParentFrame (   )  const [inline]

Definition at line 170 of file camview.h. { return m_pFrame; }

WinRect CCamView::GetPrintClipRect (  wxDC *  pPrintDC, CCPrintInfo *  pPrintInfo )  [protected]

Reimplemented in ScreenView.

virtual CNativeDC* CCamView::GetRenderDC (   )  const [virtual]

Reimplemented in ScreenView.

CRenderWnd* CCamView::GetRenderWindow (   )  const [inline]

Reimplemented in ScreenView. Definition at line 222 of file camview.h. { return(RenderWindow); }

void CCamView::GetScrollOffset (  WorkCoord *  pOffset  )  const

Reimplemented in ScreenView.

static BOOL CCamView::GetUseVisibleDefaults (   )  [inline, static]

Reimplemented in ScreenView. Definition at line 270 of file camview.h. { return UseVisibleDefaults;};

ViewState* CCamView::GetViewState (   )  const

void CCamView::GrabKernelAttention (   )  const [protected]

void CCamView::HandleButtonUp (  UINT32  Button, wxMouseEvent &  event )  [protected]

Finishes the current drag, if there is one, by elucidating the state of the buttons etc and calling DragDFinished() in the kernel (DocView). Called whenever a mouse button is released. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 9th Sept 1993 Parameters: Button  - which mouse button has been released. [INPUTS] nFlags - The mouse button flags. point - the coordinate of the mouse cursor. -  [OUTPUTS] Returns: - Errors: - Scope: Private See also: CCamView::GetClickMods(); CCamView::OnLButtonDown(); CCamView::OnRButtonDown() DocView::OnClick() Reimplemented in ScreenView. Definition at line 4437 of file camview.cpp. { //Graham 18/6/96: Changed the logical conditions of this function //to support clicks with one mouse button while another button is //dragging if (DocView::GetSelected() != pDocView) { ENSURE(pCurrentDragOp == NULL, "Drag operation in a view that isn't 'selected' !!"); // TRACEUSER( "JustinF", _T("Ignored button-up cos not in the selected view\n")); return; } // Set Current states... SetCurrentStates(); //Graham: Here's the change - in the logical conditions only. The actual //functions called are the same. WinCoord point; event.GetPosition( &point.x, &point.y ); //Was the button that went up the first one that went down? if (Button==FirstClickButton) { //Yes it was. //Is there a drag currently running? if (pCurrentDragOp != NULL) { // Yes there is. // Release the capture and terminate the drag. Note that we try to release // the mouse capture as soon as possible after a drag has finished, in case the // DragFinished method below brings up a dialog box or something. if (GetRenderWindow() && GetRenderWindow()->GetCapture()==GetRenderWindow()) GetRenderWindow()->ReleaseMouse(); pDocView->DragFinished(pCurrentDragOp, ((WinCoord*) &point)->ToOil(pDocView, TRUE), LastClickMods, TRUE); // Now cater for the special case that the user used the PushCentreTool Click Modifier // and they didn't move the mouse - this means they either wanted to Centre the // view about the cursor, ZoomIn() or ZoomOut() depending on the modifiers....