ScreenView Class Reference

A subclass of CCamView which is the class actually used for screen display. More...

#include <scrvw.h>

Inheritance diagram for ScreenView:

List of all members.

Public Member Functions
	ScreenView ()
	Default constructor for a ScreenView 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	~ScreenView ()
	Destroys a ScreenView window. Deletes child windows first. Updates the ScreenView population counter.
void	SetViewStateFromThis () const
	Called by a virgin ScreenView, ie. a view onto a new, unedited document. The function reads the attributes of the view window from the operating system, converts them into a device- independent form, and stores them in the ViewState.
void	SetThisFromViewState ()
	Move and resize the ScreenView according to the (device-independent) settings of a ViewState object. This typically happens when a new view is opened on a saved document.
virtual BOOL	IsScreenView ()
MouseOverRulerHit	IsMouseOverRuler ()
BOOL	IsTopmost () const
	Tests if this ScreenView is the active view, ie. is on top of all other views.
BOOL	ShouldEatClick () const
void	ClearEatFlag ()
wxDC *	GetRenderDC () const
	Allows the kernel to draw on the client area at times other than when processing WM_PAINT messages. Note that the pointer returned is temporary and should NOT be stored away for future use - it may well become invalid on the next idle event.
wxWindow *	GetRenderWindow () const
	Allows the kernel to access to the render window, useful on the odd occasion, although it does distort "encapsulation".
virtual void	GetClientSize (int *width, int *height) const
	Updates the ViewState object with the view's position, in an OS- independent form. This message is sent by the view's frame window whenever it is moved. Calculates the size of the ScreenView's RendWnd.
void	InvalidateView (const OilRect *pRect=0, BOOL updatenow=FALSE)
	Invalidates the appropriate section of the RendWnd client area - if the passed parameter is NULL then the whole client area is invalidated. The rectangle will be redrawn at some time in the (near) future.
virtual void	OnDraw (wxDC *pDc)
	Makes sure that the kernel knows which view to render into. Retrieves the clipping rectangle from the CDC. Passes the CDC and the rectangle to DocView::OnDraw(), which does the actual rendering.
virtual BOOL	OnPreparePrinting (CPrintInfo *pInfo)
	Current just returns that value of CView::DoPreparePrinting().
BOOL	GetScrollerStyle () const
	Tests whether proportional scroll bars are currently in operation.
void	SetScrollerStyle (BOOL proportional)
	Allows DocView to change the style - groovy or dull - of ScreenView's scroll bars. Records the setting and calls the appropriate functions of the scroll bar gadgets.
void	SetWorkAreaExtent (const WorkRect &area, BOOL redraw=TRUE)
	Provides read-only access to the WorkAreaExtent, as maintained by DocView/ScreenView. Calculates the size of the RendWnd, setting the "page size" of the scroll bars accordingly. Sets the scroll range of the scroll bars to the size of the WorkAreaExtent (note that the Y range is negated and inverted - the mother of all bodges).
void	GetScrollOffset (WorkCoord *pOffset) const
	Reads the offset from the horizontal and vertical scroll bars, combining then into a WorkCoord.
void	SetScrollOffset (const WorkCoord &pos, BOOL redraw=TRUE)
	Changes the scroll offset in the horizontal and vertical scroll bar. Note that it DOES NOT immediately scroll the client area, which is only done when the scroll bars send back a WM_SCROLLEREVENT message to the ScreenView.
void	ShowScrollers (BOOL Show)
	Hide or Show Scrollers.
void	ShowRulers (BOOL Show)
	Hide or Show Rulers.
BOOL	AreRulersVisible ()
BOOL	AreScrollersVisible ()
void	RecaptureMouseOnNextUpdate (void)
	Called by the OLE drag & drop system (CCamDropSource::QueryContinueDrag, winoil.cpp) when dragging a selection - if the mouse pointer goes outside the view, the selection drag is "paused", and an OLE drag is started. If the pointer comes back into our view, we cancel the OLE drag and resume the selector drag - the only thing we need to do to resume is to reclaim the mouse capture (but we must do it on the next idle to ensure that we get & keep the capture, so we flag it here and fix it up in OnTimer, above).
BOOL	StartDrag (Operation *pOp, DragType type, BOOL KeepAccuracy)
	Begins a drag operation, from the point of view of the OIL layer. Unbounds the mouse cursor, so it can go off-screen (display driver permitting). Captures all mouse input, to guarantee that the drag being started will terminate properly at some time in the future. Sets some internal variables indicating that ScreenView is in "drag mode". Finally, asks the system for a timer which is used to generate "idle" mouse events.
BOOL	EndDrag (Operation *pOp)
	Finishes a drag operation in the OIL layer. Releases mouse capture and restores the previous mouse cursor clipping rectangle (generally the screen). Sets internal variables to indicate that ScreenView is not in "drag mode". Kills the timer set in StartDrag().
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 ()
	Clear the current click state so that any logic in progress is stopped before it does anything nasty.
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	IsWaitingMouseMove ()
	There are some things in Camelot that are processed as a result of a mouse move message (Magnetic snapping to all the objects in the document for example). If these operations take a long time, there is little point in carrying on with the calculations if the mouse has already moved away from the coord being tested (and hence invalidating the findings of the search). This function checks to see if there is a mouse move message waiting in the queue to be processed, so that the callers can abort any processing they were doing if applicable.
BOOL	GetCurrentMousePos (OilCoord *pMousePos) const
	Finds out the current mouse position within this view window.
BOOL	CreateDragTarget (DragInformation *DragInfo)
	will create drag targets for appropriate drags
virtual BOOL	IsSelected (const CObject *pDocItem) const
	"Tests for a selected OLE client item".
void	OnFilePrint ()
void	OnFilePrintPreview ()
	Simply makes CView::OnFilePrintPreview() have public scope. Used by the menu system.
DocView *	GetDocViewPtr () const
	Used by Will's rendering system - somehow.
BOOL	IsSingleClickReallyTriple () const
BOOL	IsSingleClickReallyQuad () const
Static Public Member Functions
static BOOL	ReadViewPrefs ()
	Tries to load preferences for ScreenView, creating them with default values if they don't exist.
static INT32	HowMany ()
	None immediately springs to mind, although one day - who knows?
static DocView *	GetDocViewFromHwnd (wxWindow *hwnd)
	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 DocView *	GetDocViewFromWindowID (CWindowID WinID)
static void	SetReadyMadeViewState (ViewState *pvs)
	Calls CCamView::Create() to attach a Windows object to the previously constructed C++ object. The view has a standard arrow cursor and a custom icon (_R(IDR_CAMTYPE)). The view is responsible for painting its background itself. The view is initially hidden, until its size and position have been properly set. Call this to set up a view-state object that ScreenView::OnInitialUpdate will use in preference to the one the ScreenView has got already. This is a nasty little "back-door" to changing the creation state of a ScreenView, used by the code that restores docs and views when the app starts. The reason we have to use code like this is that the Camelot doc/view architecture is NOT MFC.
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.
Protected Member Functions
virtual CCamCanvas *	CreateCanvas (wxView *v, wxMDIChildFrame *frame, const wxPoint &pos, const wxSize &size, long style)
void	UpdateViewPosition () const
	Updates the ViewState object shared between this ScreenView and its associated DocView with the new size of the view etc.
virtual void	OnInitialUpdate ()
virtual void	OnUpdate (wxView *sender, wxObject *hint=(wxObject *) NULL)
	Called when the view must first display the document. Moves this view/frame to the position given in the ViewState object.
virtual void	OnActivateView (bool bActivate, wxView *pActiveView, wxView *pDeactiveView)
	Called by MFC when a view gains or loses the input focus, either due to the the user clicking about, or another application popping up a window etc etc. I would just like to point out that this MFC function is the most brain-damaged Microsoft have come up so far. It's documentation bears no resemblance to the way the function is called/used - for example, as far as I can see, the two CView* parameters are NEVER different!
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	HandleDragEvent (UINT32 Button, wxMouseEvent &event, ClickType t)
	Gathers together Windows information about a mouse event and passes it on to the kernel, by calling DocView::OnClick().
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.
virtual void	HandleOleDragOutOfView (wxPoint point)
	Called when doing a DRAGTYPE_OLESCROLL and the mouse pointer moves outside the view window. The base class does nothing, so dragging continues as normal, but in the derived ScreenCamView class, this is used to cancel the internal XOR drag operation, and start an OLE drag and drop export procedure.
BOOL	PrintPaper (wxDC *pPrintDC, CCPrintInfo *pPrintInfo, PrintControl *pPrintControl)
WinRect	GetPrintClipRect (wxDC *pPrintDC, CCPrintInfo *pPrintInfo)
void	EnumeratePagePatches (CCPrintInfo *pPrintInfo)
void	OnSize (wxSizeEvent &event)
	Moved down to ScreenCamView.
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 ScreenView::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 ScreenView::HandleDragEvent().
void	OnMButtonUp (wxMouseEvent &event)
	Passes the event on to HandleButtonUp().
void	OnRButtonDown (wxMouseEvent &event)
	Same as for ScreenView::OnLButtonDown(), but for the right mouse button.
void	OnRButtonDblClk (wxMouseEvent &event)
	Same as ScreenView::OnLButtonDblClk(), bit for the right button.
void	OnRButtonUp (wxMouseEvent &event)
	Same as ScreenView::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.
afx_msg void	OnDropFiles (HDROP hDropInfo)
	Respond to files being dropped onto the view window. It sets up the current document and docview, and passes control on to the OpDroppedFile operation.
afx_msg INT32	OnMouseActivate (wxWindow *pDesktopWnd, UINT32 nHitTest, UINT32 nMessage)
afx_msg void	OnTimer (UINT32 nIDEvent)
	Called when a key is pressed, so we can do something with it. It is currently only used to adjust the Pretend Pen Pressure. THIS CODE HAS BEEN COMMENTED OUT UNTIL THE NEW KEYBOARD SYSTEM IS FULLY OPERATIONAL!! 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.
afx_msg void	OnCancelMode ()
	Called by the system whenever this window loses the focus to a dialogue box etc. Checks if the window is in drag mode, if it is makes sure that the drag is tidily cancelled, eg. the mouse is uncaptured and its clipping area restored. Calls DocView::DragFinished() (WITH JUNK PARAMETERS FOR THE MOUSE POSITION/BUTTONS) to indicate that the drag has been cancelled.
afx_msg void	OnInsertObject ()
	"Creates an embedded OLE object with a type-name retrieved from the user" - currently unimplemented.
afx_msg void	OnPaint ()
	Handles WM_PAINT messages for the ScreenView window. As the window is entirely covered by child windows, which know how to paint themselves, this function simply validates its (invisible) client area, removing the paint message. No drawing of any kind is done.
afx_msg BOOL	OnSetCursor (wxWindow *pWnd, UINT32 nHitTest, UINT32 nMessage)
	Calls the kernel DocView object to set the cursor for this ScreenView. Scope: Protected.
afx_msg LRESULT	OnScrollerEvent (WPARAM wp, LPARAM lp)
	This message is sent by the scroll bars in response to an earlier call to ScreenView::SetScrollOffset(). The scroll offset is read from the scroll bars and the ScrollPosition field of the ViewState is updated accordingly. If the WPARAM parameter is TRUE then the client area is repainted via a call to ScreenView::ScrollTo().
afx_msg LRESULT	OnRenderView (WPARAM wp, LPARAM lp)
	Responds to a WM_PAINT message sent to the RendWnd window object. Effectively tricks MFC into painting the RendWnd as if it was a CView window, not a child of a CView - calls CView::OnPrepareDC() and ScreenView::OnDraw().
afx_msg LRESULT	OnFrameMove (WPARAM x, LPARAM y)
afx_msg void	OnVScroll (UINT32 nSBCode, UINT32 nPos, CScrollBar *pScrollBar)
	The framework calls this member function when the user clicks a window's vertical scroll bar.
afx_msg void	OnHScroll (UINT32 nSBCode, UINT32 nPos, CScrollBar *pScrollBar)
	The framework calls this member function when the user clicks a window's horizontal scroll bar.
Protected Attributes
BOOL	fSetupDone
bool	fInitialUpdate
BOOL	fJustCreated
CWinScroller *	HScrollBar
CWinScroller *	VScrollBar
CScrollerCorner *	Corner
OILHorizontalRuler *	HRuler
OILVerticalRuler *	VRuler
OriginGadget *	OGadget
WinRect	CurrentSize
WorkRect	WorkArea
WorkCoord	OldOffset
BOOL	ScrollerStyle
BOOL	DragKeepAccuracy
BOOL	AutoScrollExcludeRulers
ClickType	LastClickType
UINT32	LastClickButton
wxPoint	LastClickPoint
wxPoint	CurrentMousePos
ClickModifiers	LastClickMods
UINT32	FirstClickButton
Operation *	pCurrentDragOp
DragType	CurrentDragType
WinRect	MouseClipRect
BOOL	OLERecaptureMouse
MonotonicTime	m_OLELastOutTime
String_256	DragOpToken
OpParam *	pDragOpParam
BOOL	DragOpInvoke
MonotonicTime	TimeOfLastClick
wxPoint	LastDoubleClickPos
BOOL	ThisSingleIsTriple
BOOL	ThisDoubleIsQuad
Static Protected Attributes
static INT32	PopCount
static ViewState *	pReadyMadeViewState
static BOOL	UnzoomOnNewView = FALSE
static BOOL	ZoomSingleView = TRUE
static BOOL	PropScrollersOn = TRUE
static BOOL	DefaultScrollersState = TRUE
static BOOL	DefaultRulersState = FALSE
static BOOL	UseVisibleDefaults = TRUE
static INT32	DragLatency = 3
	This function is called whenever the joystick moves. It is used currently to set the Pretend Pen Pressure from the joystick position. This function only exists under Win32.
static INT32	DragDelay = 500
static MonotonicTime	DragTimer
Classes
class	ScreenCanvas

---

Detailed Description

A subclass of CCamView which is the class actually used for screen display.

Author:

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

Date:

19/01/95

See also:

CCamView; PrintCamView

Definition at line 162 of file scrvw.h.

---

Constructor & Destructor Documentation

ScreenView::ScreenView (   )

Default constructor for a ScreenView 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. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Updates the ScreenView population counter. Called from somewhere deep inside MFC. Returns: Errors: - Scope: Protected. See also: ScreenView::OnCreate(); ScreenView::~ScreenView() Definition at line 299 of file scrvw.cpp. { // TRACEUSER( "Richard", _T("ScreenView::ScreenView()\n")); // No child windows or connections yet. // RenderWindow = NULL; HScrollBar = NULL; VScrollBar = NULL; PORTNOTE("other","Removed CScrollerCorner usage") #ifndef EXCLUDE_FROM_XARALX Corner = NULL; #endif // WEBSTER - markn 15/1/97 // No rulers in Webster #ifndef WEBSTER HRuler = NULL; VRuler = NULL; OGadget= NULL; #endif // WEBSTER // Set/clear these internal flags. fSetupDone = FALSE; fInitialUpdate = false; // Not dragging or scrolling either. ScrollerStyle = TRUE; 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; // 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; }

ScreenView::~ScreenView (   )  [virtual]

Destroys a ScreenView window. Deletes child windows first. Updates the ScreenView population counter. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Public See also: ScreenView::ScreenView() Definition at line 379 of file scrvw.cpp. { TRACEUSER( "Richard", _T("ScreenView::~ScreenView()\n")); // Deregister for WM_DROPFILES messages // VC2 Beta 1 asserts with a zero handle here so we check PORTNOTE("other","Removed DragAcceptFiles usage") #ifndef EXCLUDE_FROM_XARALX if (m_hWnd) DragAcceptFiles(TRUE); #endif // delete RenderWindow; GetCanvas()? PORTNOTE("other","Removed CWinScroller usage") #ifndef EXCLUDE_FROM_XARALX delete HScrollBar; delete VScrollBar; #endif PORTNOTE("other","Removed CScrollerCorner usage") #ifndef EXCLUDE_FROM_XARALX delete Corner; #endif // WEBSTER - markn 15/1/97 // No rulers in Webster #ifndef WEBSTER #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) delete HRuler; delete VRuler; delete OGadget; #endif #endif // WEBSTER PopCount--; // one less ScreenView in the world, sigh }

---

Member Function Documentation

BOOL ScreenView::AreRulersVisible (   )

Author: Chris_Snook (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: Ruler Visible state. Errors: - Scope: Public Reimplemented from CCamView. Definition at line 557 of file scrvw.cpp. { #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) if(Status) return Status->RulersVisible; #endif return FALSE; };

BOOL ScreenView::AreScrollersVisible (   )

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

void ScreenView::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: ScreenView::HandleDragScrolling Reimplemented from CCamView. Definition at line 3298 of file scrvw.cpp. { if( point.x < wrSize.GetLeft() ) *dx = point.x - wrSize.GetLeft(); else if( point.x >= wrSize.GetRight() ) *dx = point.x - wrSize.GetRight(); else *dx = 0; if( point.y < wrSize.GetTop() ) *dy = point.y - wrSize.GetTop(); else if( point.y >= wrSize.GetBottom() ) *dy = point.y - wrSize.GetBottom(); else *dy = 0; }

BOOL ScreenView::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 from CCamView. Definition at line 2982 of file scrvw.cpp. { // Change the current drag type CurrentDragType = Type; m_OLELastOutTime.Sample(); OLERecaptureMouse = FALSE; return TRUE; }

void ScreenView::ClearClickState (   )

Clear the current click state so that any logic in progress is stopped before it does anything nasty. Author: Phil_Martin (Xara Group Ltd) <camelotdev@xara.com> Date: 26/02/2004 Reimplemented from CCamView. Definition at line 4169 of file scrvw.cpp. { LastClickType = CLICKTYPE_NONE; if( GetParentFrame()->HasCapture() ) { GetParentFrame()->ReleaseMouse(); } }

void ScreenView::ClearEatFlag (   )

virtual CCamCanvas* ScreenView::CreateCanvas (  wxView *  v, wxMDIChildFrame *  frame, const wxPoint &  pos, const wxSize &  size, long  style )  [inline, protected, virtual]

Reimplemented in ScreenCamView. Definition at line 197 of file scrvw.h. : Correct */ long style ) { return new ScreenCanvas( v, frame, pos, size, style ); }

BOOL ScreenView::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 from CCamView. Definition at line 650 of file scrvw.cpp. { #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // 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->m_hWnd,NULL,DragInfo); return TRUE; } #endif return FALSE; }

BOOL ScreenView::EndDrag (  Operation *  pOp  )

Finishes a drag operation in the OIL layer. Releases mouse capture and restores the previous mouse cursor clipping rectangle (generally the screen). Sets internal variables to indicate that ScreenView is not in "drag mode". Kills the timer set in StartDrag(). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  pointer to the current drag operation (currently not used). [INPUTS] -  [OUTPUTS] Returns: TRUE if the drag is successfully terminated. Errors: ASSERTion failure if ScreenView was not already in "drag mode". Scope: Public See also: ScreenView::StartDrag(); ScreenView::HandleDragEvent() Reimplemented from CCamView. Definition at line 2930 of file scrvw.cpp. { /* #ifdef _DEBUG // Prevent a very nasty recursive ENSURE! if (!CCamApp::IsDisabled()) { ENSURE(pCurrentDragOp != 0, "ScreenView::EndDrag: pCurrentDragOp is zero"); } #endif // _DEBUG */ // Restore the previous mouse clipping rectangle. Windows will move the // mouse, if necessary, so that the mouse is within the new clipping // rectangle (or so the documentation says!) //::ClipCursor(&MouseClipRect); pCurrentDragOp = 0; FirstClickButton = 0; DragKeepAccuracy = TRUE; if (m_pCanvas && m_pCanvas->GetCapture() == m_pCanvas) m_pCanvas->ReleaseMouse(); // Check status of temporary tool selection - this is because we don't change tool // mid-drag! (e.g. user holds down Alt to get selector, starts drag, releases Alt, // then ends drag - we want to restore the original tool). Tool::EndDrag(); // Kill the timer started in HandleDragEvent(). PORTNOTE("other","Removed FixKillTimer usage") #ifndef EXCLUDE_FROM_XARALX return ::FixKillTimer(m_hWnd, 1); #else return TRUE; #endif }

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

Reimplemented from CCamView.

void ScreenView::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: ScreenView::HandleDragEvent() Reimplemented from CCamView. Definition at line 2259 of file scrvw.cpp. { *p = ClickModifiers::GetClickModifiers(event); }

void ScreenView::GetClientSize (  int *  pWidth, int *  pHeight )  const [virtual]

Updates the ViewState object with the view's position, in an OS- independent form. This message is sent by the view's frame window whenever it is moved. Calculates the size of the ScreenView's RendWnd. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] The  width and height of the client area which the kernel can render into. [OUTPUTS] Returns: - Errors: - Scope: Public See also: class CRendWnd Reimplemented from CCamView. Definition at line 1429 of file scrvw.cpp. : Correct */ { // OilRect r = CurrentSize.ToOil(pDocView); // *pWidth = r.Width(); // *pHeight = r.Height(); WinRect wrect(0,0,0,0); GetCanvas()->GetClientSize(&wrect.width,&wrect.height); OilRect orect = wrect.ToOil(pDocView); *pWidth = orect.Width(); *pHeight = orect.Height(); }

BOOL ScreenView::GetCurrentMousePos (  OilCoord *  pMousePos  )  const

Finds out the current mouse position within this view window. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 12/10/94 Parameters: -  [INPUTS] pMousePos  the mouse position within this view, in OIL coordinates [OUTPUTS] Returns: TRUE if the mouse is within this view, and hence that *pMousePos holds its position; FALSE if the mouse is outside the view (in which case pMousePos is unchanged). Errors: - See also: - Reimplemented from CCamView. Definition at line 3731 of file scrvw.cpp. { // Get the Windows screen coordinates of the mouse cursor. // Convert from screen to window coordinates. WinCoord pt; *(wxPoint *)&pt = GetCanvas()->ScreenToClient( ::wxGetMousePosition() ); // If the mouse is outside the view then we can do nothing more. if (!CurrentSize.Inside(pt)) return FALSE; // Convert to OIL coordinates. if (pMousePos!=NULL) *pMousePos = pt.ToOil(pDocView, TRUE); // We stored something useful. return TRUE; }

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

Reimplemented from CCamView. Definition at line 324 of file scrvw.h. { return DefaultRulersState;};

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

Reimplemented from CCamView. Definition at line 325 of file scrvw.h. { return DefaultScrollersState;};

DocView * ScreenView::GetDocViewFromHwnd (  wxWindow *  hwnd  )  [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 691 of file scrvw.cpp. { PORTNOTETRACE("other","ScreenView::GetDocViewFromHwnd - do nothing"); #ifndef EXCLUDE_FROM_XARALX // 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() == hwnd ) return pDocView; } else { // Convert from a kernel document to an OIL document. CCamDoc* pCamDoc = pKernelDoc->GetOilDoc(); // For all views onto the OIL document . . . POSITION pos = pCamDoc->GetFirstViewPosition(); while (pos != NULL) { // Compare the handle of the view's render window to the given handle, // returning the associated DocView if they match. ScreenView* pCamView = (ScreenView*) pCamDoc->GetNextView(pos); // Not interested unless it is a ScreenView (it could be a print preview view) if (pCamView->IsKindOf(RUNTIME_CLASS(ScreenView))) { if (pCamView->RenderWindow->m_hWnd == hwnd) { return pCamView->pDocView; } } } } } #endif // Couldn't find the handle, so return nothing. return NULL; }

DocView * ScreenView::GetDocViewFromWindowID (  CWindowID  WinID  )  [static]

Author: Ed_Cornes (Xara Group Ltd) <camelotdev@xara.com> Date: 15/1/95 Parameters: Window  ID [INPUTS] Returns: A pointer to the DocView associated with the window ID, else NULL Also See: GetDocViewFromHwnd() Reimplemented from CCamView. Definition at line 753 of file scrvw.cpp. { return GetDocViewFromHwnd( (wxWindow *)WinID ); }

DocView * ScreenView::GetDocViewPtr (   )  const

Used by Will's rendering system - somehow. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: A pointer to the DocView object associated with this CCamView. Errors: - Scope: Public See also: Will's stuff. Reimplemented from CCamView. Definition at line 4224 of file scrvw.cpp. { return pDocView; }

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

Reimplemented from CCamView.

wxDC * ScreenView::GetRenderDC (   )  const [virtual]

Allows the kernel to draw on the client area at times other than when processing WM_PAINT messages. Note that the pointer returned is temporary and should NOT be stored away for future use - it may well become invalid on the next idle event. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 2nd Sept 1993 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: A pointer to the CDC object associated with the RenderWindow. Errors: Returns NULL if the DC could not be obtained. Scope: Public See also: ScreenView::OnDraw() Reimplemented from CCamView. Definition at line 1795 of file scrvw.cpp. { // // GAT: Warning - I don't think we want to be using this function anymore. // Create a DC when required. // PORTNOTETRACE("other","ScreenView::GetRenderDC - do nothing"); #ifndef EXCLUDE_FROM_XARALX return GetCanvas()->GetDC(); #else return NULL; #endif }

wxWindow * ScreenView::GetRenderWindow (   )  const

Allows the kernel to access to the render window, useful on the odd occasion, although it does distort "encapsulation". Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 15th October 1993 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: A pointer to the RenderWindow child of this ScreenView Errors: - Scope: Public See also: ScreenView::GetRenderDC() Reimplemented from CCamView. Definition at line 1827 of file scrvw.cpp. { return GetCanvas(); }

BOOL ScreenView::GetScrollerStyle (   )  const

Tests whether proportional scroll bars are currently in operation. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if this ScreenView is currently sporting proportional scroll bars, FALSE if it isn't, and its scroll bars look like typical naff Windows ones. Errors: - Scope: Public See also: ScreenView::SetScrollerStyle; CScroller::SetProportional() Definition at line 1934 of file scrvw.cpp. { return ScrollerStyle; }

void ScreenView::GetScrollOffset (  WorkCoord *  pOffset  )  const

Reads the offset from the horizontal and vertical scroll bars, combining then into a WorkCoord. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] The  current scroll offset is written to the passed WorkCoord. [OUTPUTS] Returns: - Errors: - Scope: Public See also: ScreenView::SetScrollOffset(); CScroller::GetScrollPos() Reimplemented from CCamView. Definition at line 2049 of file scrvw.cpp. { FIXED16 PixelWidth,PixelHeight; pDocView->GetPixelSize(&PixelWidth,&PixelHeight); // TRACE( _T("SV::GetScrollOffset\n")); // TRACE( _T("CanvasPos = (%d, %d)\n"), GetCanvas()->GetScrollPos(wxHORIZONTAL), GetCanvas()->GetScrollPos(wxVERTICAL)); pOffset->x = XLONG(WorkArea.lo.x+GetCanvas()->GetScrollPos(wxHORIZONTAL)*PixelWidth .MakeDouble()); pOffset->y = XLONG(WorkArea.hi.y-GetCanvas()->GetScrollPos(wxVERTICAL )*PixelHeight.MakeDouble()); // TRACE( _T("ScrollOffset = (%d, %d)\n"), (INT32)(pOffset->x), (INT32)(pOffset->y)); }

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

Reimplemented from CCamView. Definition at line 323 of file scrvw.h. { return UseVisibleDefaults;};

void ScreenView::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: ScreenView::GetClickMods(); ScreenView::OnLButtonDown(); ScreenView::OnRButtonDown() DocView::OnClick() Reimplemented from CCamView. Definition at line 2614 of file scrvw.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 (m_pCanvas && m_pCanvas->GetCapture()==m_pCanvas) m_pCanvas->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.... if ((LastClickPoint == CurrentMousePos) && LastClickMods.PushCentreTool) { // Did we want to ZoomIn()? if( event.ControlDown() ) { OpZoom* pZoomOp = new OpZoom; ERROR3IF(!pZoomOp,"Couldn't create pZoomOp"); // Find the mid-point of the view, in work coordinates... WorkRect wrView = pDocView->GetViewRect(); WorkCoord wcMidView((wrView.lo.x + wrView.hi.x) / 2, (wrView.lo.y + wrView.hi.y) / 2); pZoomOp->ZoomIn(wcMidView); } // Did we want to ZoomOut()? else if( event.ShiftDown() ) { OpZoom* pZoomOp = new OpZoom; ERROR3IF(!pZoomOp,"Couldn't create pZoomOp"); // Find the mid-point of the view, in work coordinates... WorkRect wrView = pDocView->GetViewRect(); WorkCoord wcMidView((wrView.lo.x + wrView.hi.x) / 2, (wrView.lo.y + wrView.hi.y) / 2); pZoomOp->ZoomOut(wcMidView); } else { // Then we must have wanted to centre the screen about the cursor... DocCoord MousePos; Spread *pSpread = Document::GetSelectedSpread(); if(!DocView::GetCurrentMousePos(&pSpread, &MousePos)) { return; } WorkCoord testwork(MousePos.ToWork(pSpread, pDocView)); // Find out where the middle of the current view is... DocRect ViewRect = (pDocView->GetDocViewRect(pSpread)).ToSpread(pSpread, pDocView); DocCoord ViewMidPoint(0,0); ViewMidPoint.x = INT32(ViewRect.lo.x + (ViewRect.hi.x - ViewRect.lo.x)/2.0); ViewMidPoint.y = INT32(ViewRect.lo.y - (ViewRect.lo.y - ViewRect.hi.y)/2.0); // Work out what the offset between the centre of the screen and the MousePos is... DocCoord Offset = MousePos - ViewMidPoint; WorkCoord ScrollOffset; WorkCoord WorkOffset; WorkOffset.x = (XLONG) (MakeXLong(Offset.x) * pDocView->GetViewScale()); WorkOffset.y = (XLONG) (MakeXLong(Offset.y) * pDocView->GetViewScale()); ScrollOffset = pDocView->GetScrollOffsets(); ScrollOffset.x = ScrollOffset.x + WorkOffset.x; ScrollOffset.y = ScrollOffset.y + WorkOffset.y; if (ScrollOffset.x < (XLONG) 0) ScrollOffset.x = (XLONG) 0; if (ScrollOffset.y > (XLONG) 0) ScrollOffset.y = (XLONG) 0; // Scroll the screen to centre about the cursor! pDocView->SetScrollOffsets(ScrollOffset, TRUE); } } } else { // No there isn't. // Kill the timer started in HandleDragEvent(), // as we don't want to wait for a drag anymore. PORTNOTE("other","Removed FixKillTimer usage") #ifndef EXCLUDE_FROM_XARALX ::FixKillTimer(m_hWnd, 1); #endif FirstClickButton = 0; //Then pass the Up-Click message to ScreenView::OnClick pDocView->OnClick(((WinCoord*) &point)->ToOil(pDocView, TRUE), CLICKTYPE_UP, LastClickMods); } } else { //No, the button that went up was not the first one to go down. //In that case, we expect the first button that went down is still down and //hence there is a drag running. //Is there a drag running? if (pCurrentDragOp != NULL) { //Yes, as expected. //Pass the Up-Click message to ScreenView::OnClick pDocView->OnClick(((WinCoord*) &point)->ToOil(pDocView, TRUE), CLICKTYPE_UP, LastClickMods); } //If not, something odd has happened - perhaps the user has clicked fast //with the mouse. This need not worry us but we should not do anything //with the up-click message. //The only problem that could occur is if we are in a button-up-drag. This //is handled below. } //Ensure there is not a button-up drag in progress //That is, there is a drag in progress AND no buttons down // ERROR3IF((Operation::GetCurrentDragOp()==NULL)&&(nFlags & ~(MK_SHIFT | MK_CONTROL) == 0), // "ScreenView::HandleButtonUp - drag operation in progress but no buttons down"); }

void ScreenView::HandleDragEvent (  UINT32  Button, wxMouseEvent &  event, ClickType  t )  [protected]

Gathers together Windows information about a mouse event and passes it on to the kernel, by calling DocView::OnClick(). Technical notes (by Tim): The Button is parameter is necessary, because sometimes when we get the *first* button down event, nFlags has more than one mouse button bit set. This only happens when you rampantly click buttons very quickly but nevertheless we *do* need to know which button was pressed, otherwise we never release the drag event and we end up with button-up-drag city. I assume this is due to some latency in Windows, e.g., it gets a button down event, and while preparing it goes and reads the mouse button state and meanwhile another button has been pressed so we get a button down event with nFlags indicating more than one button is down. Definition at line 2304 of file scrvw.cpp. { if (DocView::GetSelected() != pDocView) { // TRACEUSER( "JustinF", _T("Ignored drag-event cos not in the selected view\n")); // If selected doc is null, let's select it anyway. if (DocView::GetSelected() == NULL) { // We're in a weird state that should never happen but does - a document // has the focus, but isn't selected Document* pKDoc =NULL; if(pDocView) pKDoc = pDocView->GetDoc(); if (pKDoc) { Document::SetSelectedViewAndSpread(pKDoc, pDocView, NULL); } } return; } SetCurrentStates(); // Find out which buttons etc are down. GetClickMods(event, &LastClickMods); // If it's the first single click, then reset the drag delay timer, and ask for a // Windows timer. if (((t == CLICKTYPE_SINGLE) || (t == CLICKTYPE_DOUBLE)) && (FirstClickButton == 0)) { // Remember this event. LastClickPoint = event.GetPosition(); LastClickType = t; LastClickButton = Button; FirstClickButton = Button; DragTimer.Sample(); #if (_OLE_VER >= 0x200) // The user's doing something so don't update any container docs CCamDoc::ResetContainerUpdateTimer(); #endif PORTNOTE("other","Removed FixSetTimer usage") #ifndef EXCLUDE_FROM_XARALX // Ask the system for a timer. Fails (returns FALSE) if there isn't one available. // The timer is used to generate DragPointerIdle events, which are not directly // supported by Windows. UINT32 rate; ::SystemParametersInfo(SPI_GETKEYBOARDSPEED, 0, &rate, 0); if (!::FixSetTimer(m_hWnd, 1, rate, 0)) { ENSURE(FALSE, "Cannot get a timer in ScreenView::StartDrag()!\n"); } #endif } if (DragOpInvoke) { OpDescriptor* pOpDesc = OpDescriptor::FindOpDescriptor(DragOpToken); ERROR3IF_PF(pOpDesc == NULL,("FindOpDescriptor(%s) failed",(TCHAR*)DragOpToken)); if (pOpDesc != NULL) pOpDesc->Invoke(pDragOpParam); // Reset the vars ready for the next call to InvokeDragOp() DragOpInvoke = FALSE; pDragOpParam = NULL; } else { // Convert the click position to OIL coordinates before passing to the kernel. // pDocView->SetCurrent(); WinCoord point; event.GetPosition( &point.x, &point.y ); pDocView->OnClick( ( (WinCoord *)&point )->ToOil(pDocView, TRUE), t, LastClickMods); } }

void ScreenView::HandleDragScrolling (  wxPoint  point  )  [protected]

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. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 20th Sept 1993 Parameters: The  current position of the mouse cursor. [INPUTS] -  [OUTPUTS] Returns: - Called when ScreenView receives mouse-move messages and timer ("mouse-idle") messages. Also handles DEFERRED_SCROLLING. Returns: Errors: - Scope: Private See also: ScreenView::OnMouseMove; ScreenView::OnTimer Reimplemented from CCamView. Definition at line 3114 of file scrvw.cpp. { // Get the size of the view. We may have to deflate the rectangle a little here, if the // bottom-right edges of the view coincide with the bottom-right edges of the screen, // otherwise it is not possible to auto-scroll to the right or down as the mouse never // leaves the view window. WinRect wrSize = CurrentSize; point = GetCanvas()->ClientToScreen( point ); point = GetFrame()->ScreenToClient( point ); // WEBSTER - markn 15/1/97 // No rulers in Webster #ifndef WEBSTER #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // This is used to allow guidelines to be deleted by dropping on to the rulers - normally // we would start to auto scroll at this point which is a little off putting.. if (AutoScrollExcludeRulers && CurrentDragType != DRAGTYPE_OLESCROLL) { UINT32 RulerWidth = OILRuler::GetWidth(); wrSize.left -= RulerWidth; wrSize.top -= RulerWidth; } #endif #endif // WEBSTER PORTNOTE("other","Removed special handling for Zoomed and FullScreen") #ifndef EXCLUDE_FROM_XARALX CCamFrame* pMainWnd = GetMainFrame(); if (pMainWnd != NULL && (pMainWnd->InFullScreenMode() || pMainWnd->IsZoomed()) && CurrentDragType != DRAGTYPE_OLESCROLL) { // TRACEUSER( "JustinF", _T("Deflating bounds for special auto-scroll handling\n")); //const INT32 nMargin = (IsWin32c()) ? 4 : 8; const INT32 nMargin = (CCamApp::IsNewWindowsUI()) ? 4 : 8; wrSize.Inflate(-nMargin, -nMargin); } #endif // Initialise Deltas... INT32 dx = 0; INT32 dy = 0; // Depending on the type of the drag... switch (CurrentDragType) { //------------------------- case DRAGTYPE_NOSCROLL: break; //------------------------- case DRAGTYPE_AUTOSCROLL: { // Has the mouse moved outside there bounds? if (!wrSize.IsEmpty() && !wrSize.Inside(point)) { // The mouse is outside the view, and we have to scroll the view // proportionate to how far outside it is. CalcScrollDeltas(point,wrSize,&dx,&dy); } break; } //------------------------- case DRAGTYPE_OLESCROLL: { PORTNOTE("other","Disable DRAGTYPE_OLESCROLL") #ifndef EXCLUDE_FROM_XARALX WinRect Outer = wrSize; // Set auto-scroll region to be one scrollbar width within the current // view (as per The Windows Interface Guidelines Chapter 5). INT32 ScrollbarSize = VScrollBar->GetScrollerSize(); wrSize.Inflate(-ScrollbarSize,-ScrollbarSize); if (!wrSize.IsEmpty() && !Outer.IsEmpty() && !wrSize.Inside(point) // Outside allowed scroll rectangle ) { if (Outer.Inside(point)) // and still inside visible window { // If we've been in the OLE scroll region for long enough if (m_OLELastOutTime.Elapsed(100)) { // NOTE: According to Windows Interface Guidelines Chapter 5 we should // Test the "speed" of the mouse here but because we have already // checked that the mouse has been in the region for longer than 100 // milliseconds it doesn't seem neccessary. (To be within the region // for longer than 100 milliseconds is sort of a speed test anyway!) // The mouse is in the scroll region, and we have to scroll the view // proportionate to how far into the region it is. CalcScrollDeltas(point,wrSize,&dx,&dy); } } else { // We've dragged beyond the OLE scroll area, so we can now convert the drag // into an OLE export drag if we so desire. HandleOleDragOutOfView(point); } } else { // We're not in the OLE scroll region so reset the timer m_OLELastOutTime.Sample(); } #endif break; } //------------------------- case DRAGTYPE_DEFERSCROLL: { // If the mouse is within the window, and we are performing deferred-scrolling // then we can change over to auto-scrolling. if (!wrSize.IsEmpty() && wrSize.Inside(point)) { CurrentDragType = DRAGTYPE_AUTOSCROLL; AutoScrollExcludeRulers = TRUE; } break; } default: ERROR3("Shouldn't ever get here!"); break; } //------------------------------------ // Now do the scroll if necessary... // If dx<>0 or dy<>0 and scroll lock is disabled // Test if the SCROLL LOCK key has been set. if( !wxGetKeyState( CAMKEY(SCROLL) ) && !(dx==0 && dy==0)) { // Set Current states... SetCurrentStates(); // Convert these pixel values into a WorkCoord offset, add to the // scroll position and update the scroll bars etc. Note that the // y offset is subtracted as the y-axis is reversed compared to // Windows . . . WorkCoord offset; GetScrollOffset(&offset); FIXED16 PixelWidth, PixelHeight; pDocView->GetPixelSize(&PixelWidth, &PixelHeight); offset.x += dx * PixelWidth; offset.y -= dy * PixelHeight; WorkRect wrScrollRect = GetMaxScrollRect(); if (offset.x < wrScrollRect.lo.x) offset.x = wrScrollRect.lo.x; if (offset.y < wrScrollRect.lo.y) offset.y = wrScrollRect.lo.y; if (offset.x > wrScrollRect.hi.x) offset.x = wrScrollRect.hi.x; if (offset.y > wrScrollRect.hi.y) offset.y = wrScrollRect.hi.y; // By calling DocView to do the scroll we give it a chance to remove // any blobbies it might have put on the screen. Note that the scrollers // will prevent any overscroll. pDocView->SetScrollOffsets(offset, TRUE); } }

BOOL ScreenView::HandleMouseWheelEvent (  wxMouseEvent &  event  )  [protected]

Reimplemented from CCamView. Definition at line 2399 of file scrvw.cpp. { // Reasons Why This Is Done As It Is... // ************************************ // // The WM_MOUSEWHEEL message is only ever sent to the window with focus. Galleries // never have the focus, even though they show they have (their windows are highlighted) // as this is done using rendering onto a blank window (as is their grey-ing out) // As a result of this, a Gallery is never sent a WM_MOUSEWHEEL message. // We therefore need to trap the message (here is as good a place as any) and check if the // user was actually over a gallery... // Finding out if they are over a Gallery SHOULD have been quite easy (eg WindowFromPoint()) // EXCEPT that we don't create the Galleries in any sensible manner, thus they aren't // children of the current window - they are children of the Program Manager - sensible... // So, when we ask for the appropriate HWND it returns a nonsense value... Anyhow, the // following code gets around this and gives us the real HWND of the Gallery underneath the // mouse, OR returns NULL if no bar was found. // In the case where we get the Gallery HWND, we dispatch a message to scroll up/down according // to mousewheel delta. In the case where we have no HWND we check if the mouse lies within the // currently selected view and if it does, then scroll appropriately. // If anyone can see an easier way, then let me know!!! // Matt 1/11/00 PORTNOTETRACE("other","ScreenView::HandleMouseWheelEvent - do nothing"); #ifndef EXCLUDE_FROM_XARALX // We need to know if the mouse pointer is over a Gallery, and if it is what the // HWND of that Gallery is, so that I can send it a scroll message... HWND OverBar = GetMainFrame()->IsScreenPointInBar(pt); if (OverBar) { if (zDelta < 0) { BROADCAST_TO_CLASS(DialogMsg(OverBar, DIM_MOUSEWHEEL_DOWN, 256), DialogOp); } else { BROADCAST_TO_CLASS(DialogMsg(OverBar, DIM_MOUSEWHEEL_UP, 256), DialogOp); } } else { //Preliminary Checks... if (DocView::GetSelected() != pDocView) { // If selected doc is null, let's select it anyway. if (DocView::GetSelected() == NULL) { // We're in a weird state that should never happen but does - a document // has the focus, but isn't selected Document* pKDoc =NULL; if(pDocView) { pKDoc = pDocView->GetDoc(); } if (pKDoc) { Document::SetSelectedViewAndSpread(pKDoc, pDocView, NULL); } } return FALSE; } SetCurrentStates(); // We now need to work out if the Mouse is currently over part of the document - if it isn't // then we should ignore the message and let something else handle it... Spread* pSpread = Document::GetSelectedSpread(); if (pSpread == NULL) { return FALSE; } DocCoord MousePos; if(!DocView::GetCurrentMousePos(&pSpread, &MousePos)) { return FALSE; } #if (_OLE_VER >= 0x200) // The user's doing something so don't update any container docs CCamDoc::ResetContainerUpdateTimer(); #endif //If the user is holding down CTRL whilst scrolling the wheel, then we should do the standard zoom-in/out if (nFlags & MK_CONTROL) { // TRACEUSER( "Matt", _T("MouseWheel + CTRL = Zoom, in ScreenView\n")); // Try to create an instance of the zoom operation. OpZoom* pZoomOp = new OpZoom; if (pZoomOp == NULL) { // We ran out of memory, so sorry. InformError(_R(IDE_NOMORE_MEMORY)); return FALSE; } DocCoord DocMouse = MousePos.ToDoc(pSpread, pDocView); WorkCoord WorkMouse; WorkMouse = DocMouse.ToWork(pSpread, pDocView); // Get the current view's scaling factor as a rounded precentage. INT32 nOldScalePercent = ((pDocView->GetViewScale() * 100) + FIXED16_DBL(0.5)).MakeInt(); // Zoom in or out around the mouse position... if (zDelta > 0) { // Search backwards until we find a higher zoom, or the end of the table for (INT32 i = cZoomTableSize - 1; i >= 0; i--) { // Found a higher zoom? If so, set it, remember it's position and return. if (nOldScalePercent < pZoomOp->GetPresetZoomPercent(i)) { // Do the zoom. We will (optionally) end the operation. pDocView->SetZoomTableIndex(i); // pZoomOp->ZoomAtPoint(WorkMouse, pZoomOp->GetPresetZoomScale(i), FALSE); pZoomOp->MouseWheelZoomAtPoint(WorkMouse, pZoomOp->GetPresetZoomScale(i), FALSE); break; } } // pZoomOp->ZoomIn(WorkMouse); } else { // Search forwards through the zoom table until we find a lower zoom factor for (INT32 i = 0; i < cZoomTableSize; i++) { // Found a lower zoom? If so, set it, remember it's position in the zoom table if (nOldScalePercent > pZoomOp->GetPresetZoomPercent(i)) { // Do the zoom. We will (optionally) end the operation. pDocView->SetZoomTableIndex(i); // pZoomOp->ZoomAtPoint(WorkMouse, pZoomOp->GetPresetZoomScale(i), FALSE); pZoomOp->MouseWheelZoomAtPoint(WorkMouse, pZoomOp->GetPresetZoomScale(i), FALSE); break; } } // pZoomOp->ZoomOut(WorkMouse); } // Tidy away... delete pZoomOp; return TRUE; } else { // The CTRL key was not pressed, so we should simply (is anything simple around here) // scroll the viewport up/down. (OR left/right if SHIFT is held down - Matt 16/11/2000) // TRACEUSER( "Matt", _T("MouseWheel = Scroll, in ScreenView\n")); if (nFlags & MK_SHIFT) { // If HScrollBar doesn't exist at this point then something's not quite right... if(!HScrollBar) { return FALSE; } // Get the current Horizontal Scroll Position, increment it by a zoom-dependent amount // and set the Horizontal Scroll Position to be this value, flagging it to redraw... XLONG horizpos; HScrollBar->GetScrollPos(&horizpos); horizpos -= (XLONG)((zDelta/120) * 750 * 15); HScrollBar->SetScrollPos(horizpos, true); } else { // If VScrollBar doesn't exist at this point then something's not quite right... if(!VScrollBar) { return FALSE; } // Get the current Vertical Scroll Position, increment it by a zoom-dependent amount // and set the Vertical Scroll Position to be this value, flagging it to redraw... XLONG vertpos; VScrollBar->GetScrollPos(&vertpos); vertpos -= (XLONG)((zDelta/120) * 750 * 15); VScrollBar->SetScrollPos(vertpos, true); } // NOTE : If we wanted to be really flash, we could make the scroll distance affected by the // user's settings in the Control Panel - ie, default is to scroll 3 lines on 120 zDelta, but // can be adjusted so we could look at that value... } // tell everyone we've changed the screen BROADCAST_TO_ALL(ScreenChangeMsg()); } #endif // If we get to here, then we must have handled the MouseWheel, so return true... return TRUE; }

void ScreenView::HandleOleDragOutOfView (  wxPoint  point  )  [protected, virtual]

Called when doing a DRAGTYPE_OLESCROLL and the mouse pointer moves outside the view window. The base class does nothing, so dragging continues as normal, but in the derived ScreenCamView class, this is used to cancel the internal XOR drag operation, and start an OLE drag and drop export procedure. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 26/9/96 Notes: May cancel the current Drag Op Scope: Protected See also: ScreenCamView::HandleOleDragOutOfView Definition at line 3339 of file scrvw.cpp. { // The base class does nothing - this should keep Ralph happy }

INT32 ScreenView::HowMany (   )  [static]

None immediately springs to mind, although one day - who knows? Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: The number of ScreenViews existing at the moment. Errors: - Scope: Public See also: ScreenView::ScreenView(); ScreenView::~ScreenView(); Definition at line 536 of file scrvw.cpp. { return PopCount; }

void ScreenView::InvalidateView (  const OilRect *  pRect = 0, BOOL  updatenow = FALSE )

Invalidates the appropriate section of the RendWnd client area - if the passed parameter is NULL then the whole client area is invalidated. The rectangle will be redrawn at some time in the (near) future. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  pointer to the client area rectangle, an OilRect, which is to be [INPUTS] invalidated (marked as needing to be redrawn). This parameter may be omitted. If the first parameter is present, an optional second parameter may be specified, which if TRUE tells Windows to immediately send a WM_PAINT message to the view, which will force an instant redraw of any invalid areas (normally Windows waits until all other messages have been processed before sending the WM_PAINT message). -  [OUTPUTS] Returns: - Errors: - Scope: Public See also: class CRendWnd; ScreenView::OnDraw() Reimplemented from CCamView. Definition at line 1466 of file scrvw.cpp. { if (pRect != NULL) { // Convert passed rectangle to an MFC-derived type and invalidate it. Add an extra // pixel to the right and bottom edges of the rectangle to ensure that the whole // rectangle, after scaling and rounding, is invalidated. WinRect r = pRect->ToWin( pDocView ); r.width++; r.height++; GetCanvas()->Refresh( true, &r ); } else { // We are completely redrawing the client area, so it is possible that the // "cached" previous scroll offsets, contained in OldOffset, will become // incorrect. GetCanvas()->Refresh( true ); GetScrollOffset(&OldOffset); } if (updatenow) GetCanvas()->Update(); }

BOOL ScreenView::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. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 21/9/95 Parameters: OpToken  = Op token of op to invoke [INPUTS] pParam = ptr to a param block that's passed to the op NOTE! Object at *pParam must have a long life time. I.e. do NOT call this func with ptr to a local OpParam var Flags = flags that specify which modifiers were down during the click point = screen coord of the start of the drag -  [OUTPUTS] Returns: Returns TRUE if successful. Returns FALSE if not This allows a drag op to be started directly, instead of being a result of a tool handling the click. This allows you to write drag ops in the usual way. If pParam is NULL, the op's Do() function will be called. If pParam != NULL, the op's DoWithParam(pParam) func will be called. Either way, Operation::StartDrag() should be called as a result. It was introduced to allow the rulers to create guidelines undoably, no matter what tool you are in. See winoil.cpp & kernel.cpp & OpGuideLine Returns: Errors: - Scope: - See also: - Reimplemented from CCamView. Definition at line 2851 of file scrvw.cpp. { PORTNOTETRACE("other","ScreenView::InvokeDragOp - do nothing"); #ifndef EXCLUDE_FROM_XARALX DragOpToken = *pOpToken; pDragOpParam = pParam; DragOpInvoke = TRUE; PostMessage(WM_LBUTTONDOWN,Flags,point.x | (point.y << 16)); #endif return TRUE; }

MouseOverRulerHit ScreenView::IsMouseOverRuler (   )

Author: Chris_Snook (Xara Group Ltd) <camelotdev@xara.com> Date: 1/10/95 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: enum MouseOverRulerHit can be OVER_NO_RULERS, OVER_HORIZONTAL, OVER_VERTICAL, OVER_ORIGIN_GADGET. Errors: - Scope: Public Reimplemented from CCamView. Definition at line 605 of file scrvw.cpp. { // WEBSTER - markn 15/1/97 // No rulers in Webster #ifndef WEBSTER #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // check that we have some rulers if(!HRuler||!VRuler||!OGadget) return OVER_NO_RULERS; // get the mouse position in screen coords wxPoint ScrMousePos; ::GetCursorPos(&ScrMousePos); // get the HWND under the mouse HWND ThisControl = ::WindowFromPoint(ScrMousePos); // check the HWND against the rulers if(ThisControl == HRuler->GetSafeHwnd()) return OVER_HORIZONTAL; else if(ThisControl == VRuler->GetSafeHwnd()) return OVER_VERTICAL; else if(ThisControl == OGadget->GetSafeHwnd()) return OVER_ORIGIN_GADGET; #endif #endif // WEBSTER return OVER_NO_RULERS; };

virtual BOOL ScreenView::IsScreenView (   )  [inline, virtual]

Definition at line 223 of file scrvw.h. { return TRUE; }

BOOL ScreenView::IsSelected (  const CObject *  pDocItem  )  const [virtual]

"Tests for a selected OLE client item". Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  constant pointer to a CObject which is a candidate for some [INPUTS] OLE action. -  [OUTPUTS] Returns: TRUE if the parameter is selected in this view. Errors: - Scope: Public See also: ScreenView::OnInsertObject() Definition at line 4252 of file scrvw.cpp. { // TODO: implement this function that tests for a selected OLE client item #if (_OLE_VER >= 0x200) // This implementation is adequate if your selection only consists of CCamCntrItems. // To handle different selection mechanisms, this implementation should be changed. return pDocItem == m_pSelection; #else return FALSE; #endif }

BOOL ScreenView::IsSingleClickReallyQuad (   )  const [inline]

Reimplemented from CCamView. Definition at line 450 of file scrvw.h. {return ThisDoubleIsQuad;}

BOOL ScreenView::IsSingleClickReallyTriple (   )  const [inline]

Reimplemented from CCamView. Definition at line 449 of file scrvw.h. {return ThisSingleIsTriple;}

BOOL ScreenView::IsTopmost (   )  const

Tests if this ScreenView is the active view, ie. is on top of all other views. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 17/11/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if this view is the active view. Errors: - See also: - Reimplemented from CCamView. Definition at line 1249 of file scrvw.cpp. { PORTNOTETRACE("other","ScreenView::IsTopmost - do nothing"); #ifndef EXCLUDE_FROM_XARALX // always true for ralph #ifdef RALPH return TRUE; #else return ( (wxView *)this ) == GetParentFrame()->GetActiveView(); #endif #else return TRUE; #endif }

BOOL ScreenView::IsWaitingMouseMove (   )

There are some things in Camelot that are processed as a result of a mouse move message (Magnetic snapping to all the objects in the document for example). If these operations take a long time, there is little point in carrying on with the calculations if the mouse has already moved away from the coord being tested (and hence invalidating the findings of the search). This function checks to see if there is a mouse move message waiting in the queue to be processed, so that the callers can abort any processing they were doing if applicable. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 23/11/94 Returns: TRUE if there is a mouse move message waiting to be processed Reimplemented from CCamView. Definition at line 3013 of file scrvw.cpp. { #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) MSG Msg; // if there is a current drag all messages will be routed to the drag capture // capture window so there's no point in looking in this queue if(DragManagerOp::GetCurrentManager()==NULL) { while (PeekMessage(&Msg,m_hWnd, WM_MOUSEMOVE, WM_MOUSEMOVE, PM_NOREMOVE)) { // Check that this message is meant for this CamView OR it's RenderWindow child // window because the OS sometimes leaves the RenderWindow handle in the MouseMove // message (that window was the first to receive the message) if (m_hWnd==Msg.hwnd || Msg.hwnd==GetCanvas()->m_hWnd) { // There is a mouse move message in the queue. // Have to cast to INT8 so we get correct sign-extension. wxPoint Point; Point.x = (INT8) LOWORD(Msg.lParam); Point.y = (INT8) HIWORD(Msg.lParam); // See if this mouse move message is different from the last one if (Point!=CurrentMousePos) return TRUE; // Sadly, it was the same as the last one // so remove it from the queue as this should not happen PeekMessage(&Msg, m_hWnd, WM_MOUSEMOVE, WM_MOUSEMOVE, PM_REMOVE); } else { // Peek message bug. Gave me a message for someone elses window // Have to return something, so we will assume that there was not // a message in the queue. return FALSE; } } } else // there is a current drag { if(DragManagerOp::GetDragCaptureWnd()!=NULL){ while (PeekMessage(&Msg,DragManagerOp::GetDragCaptureWnd()->m_hWnd,WM_MOUSEMOVE, WM_MOUSEMOVE, PM_NOREMOVE)) { // Check that this message is meant for this CamView OR it's RenderWindow child // window because the OS sometimes leaves the RenderWindow handle in the MouseMove // message (that window was the first to receive the message) if (Msg.hwnd==DragManagerOp::GetDragCaptureWnd()->m_hWnd) { // There is a mouse move message in the queue. // Have to cast to INT8 so we get correct sign-extension. wxPoint Point; Point.x = (INT8) LOWORD(Msg.lParam); Point.y = (INT8) HIWORD(Msg.lParam); // See if this mouse move message is different from the last one if (Point!=CurrentMousePos) return TRUE; // Sadly, it was the same as the last one // so remove it from the queue as this should not happen PeekMessage(&Msg, m_hWnd, WM_MOUSEMOVE, WM_MOUSEMOVE, PM_REMOVE); } else { // Peek message bug. Gave me a message for someone elses window // Have to return something, so we will assume that there was not // a message in the queue. return FALSE; } } } } #endif // there were no mouse move messages in the queue return FALSE; }

void ScreenView::OnActivateView (  bool  bActivate, wxView *  pActiveView, wxView *  pDeactiveView )  [protected, virtual]

Called by MFC when a view gains or loses the input focus, either due to the the user clicking about, or another application popping up a window etc etc. I would just like to point out that this MFC function is the most brain-damaged Microsoft have come up so far. It's documentation bears no resemblance to the way the function is called/used - for example, as far as I can see, the two CView* parameters are NEVER different! Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  boolean which if TRUE means that this view is being activated, if FALSE [INPUTS] that this view is being deactivated; two pointers to the CView objects which are being activated/deactivated. Possibly  changes the pointed-to views. [OUTPUTS] Returns: - Errors: - Scope: Protected See also: Pretty unique, this one, so I can't think of anything to put here. Reimplemented from CCamView. Definition at line 1201 of file scrvw.cpp. { if ( !pDocView ) { TRACE( _T("ScreenView::OnActivateView - Warning: pDocView uninitialised\n") ); return; } if (bActivate) SetCurrentStates(); Document* KernelDoc = NULL; if (pDocView) KernelDoc = pDocView->GetDoc(); // MFC does some hidden stuff here . . . CCamView::OnActivateView( bActivate, pActiveView, pDeactiveView ); // Trigger off some messages into the kernel. if (bActivate) { // make sure the global preference reflects the current state SetDefaultRulersState(Status->RulersVisible); SetDefaultScrollersState(Status->ScrollersVisible); // Update our records of who is top-most and set the keyboard input focus to // the rendering child window. GetCanvas()->SetFocus(); // Inform the kernel that the view's Z-order has changed. This sets the selected // View, Document, and spread, to legal values. Document::SetSelectedViewAndSpread(KernelDoc, pDocView, NULL); } }

void ScreenView::OnCancelMode (   )  [protected]

Called by the system whenever this window loses the focus to a dialogue box etc. Checks if the window is in drag mode, if it is makes sure that the drag is tidily cancelled, eg. the mouse is uncaptured and its clipping area restored. Calls DocView::DragFinished() (WITH JUNK PARAMETERS FOR THE MOUSE POSITION/BUTTONS) to indicate that the drag has been cancelled. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 22nd Sept 1993 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: DocView::DragFinished(); ScreenView::EndDrag() Definition at line 3940 of file scrvw.cpp. { SetCurrentStates(); // If the system is disabled all messages should be ignored if (!pCurrentDragOp) return; // Make sure the capture is released. ::ReleaseCapture(); if (!CCamApp::IsDisabled()) pDocView->DragFinished(pCurrentDragOp, OilCoord(0, 0), LastClickMods, FALSE); // EndDrag(pCurrentDragOp); }

void ScreenView::OnDraw (  wxDC *  pDC  )  [virtual]

Makes sure that the kernel knows which view to render into. Retrieves the clipping rectangle from the CDC. Passes the CDC and the rectangle to DocView::OnDraw(), which does the actual rendering. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  pointer to the CDC object to render into. [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Public See also: CView::OnPrepareDC(); ScreenView::OnRenderView(); DocView::OnDraw() Reimplemented from CCamView. Definition at line 1606 of file scrvw.cpp. { // TRACE( _T("ScreenView::OnDraw\n")); if (pDocView==NULL) return; // Set the current DocView, ie. the DocView being worked upon. (and the Doc!) pDocView->SetCurrent(); (pDocView->GetDoc())->SetCurrent(); // Are we printing? PORTNOTE("print","Removed Printing from OnDraw") #ifndef EXCLUDE_FROM_XARALX if (pDC->IsPrinting()) { //TRACE( _T("BAD ! ScreenView::OnDraw reckons we're printing\n")); #ifndef STANDALONE // Yes - do the printing! // Find out from the display context the rectangle bounding the invalid // region. WinRect clip; if (pDC->GetClipBox(&clip) == NULLREGION) return; // Pass the drawing parameters on to the associated PrintView object. pPrintView->AttachToDC(pDC); pPrintView->OnDraw(pDC, clip.ToOil(pPrintView)); pPrintView->AttachToDC(NULL); #endif } else #endif { WinRect clip; // wxWidget only provides a unified accessor, so that's // what we'll use wxRegionIterator upd( m_pCanvas->GetUpdateRegion() ); // get the update rect list while( upd ) { clip.x = upd.GetX(); clip.y = upd.GetY(); clip.width = upd.GetW(); clip.height = upd.GetH(); // DumpRect( pDC, &clip, wxT("OnDraw UpdateRect : ") ); OilRect oRect = clip.ToOil( pDocView ); // TRACE( _T("OilRect = (%d, %d) - (%d, %d)\n"), oRect.lo.x, oRect.lo.y, oRect.hi.x, oRect.hi.y); pDocView->OnDraw( pDC, oRect ); upd ++ ; } //#pragma message( __LOCMSG__ "ScreenView::OnDraw - Forcing redraw" ) //TRACE( _T("ScreenView::OnDraw - Forcing redraw") ); // Camelot.GetRegionList()->ImmediateRender(true); #if FALSE // Find out from the display context the rectangle bounding the invalid // region. If we can, try to use lists of rectangles. wxRect *lpRect; UINT32 count = CCDC::GetRectangleList( pDC, &lpRect ); TRACE( _T("ScreenView::OnDraw called with %d regions\n"), count); // If there's more than one rectangle then iterate through them all... if (count > 1) { while (count--) { clip.x = lpRect->x; clip.x = lpRect->y; clip.width = lpRect->width; clip.height = lpRect->height; DumpRect( pDC, &clip, "camrect1" ); pDocView->OnDraw( pDC, clip.ToOil(pDocView) ); lpRect++; } } else { //TRACE( _T("ScreenView::OnDraw doing simple rectangle stuff")); // . . . else handle the simple <2 rectangle code pDC->GetClippingBox( clip ); if( !clip.IsEmpty() ) { // Pass the drawing parameters on to the associated DocView object. DumpRect( pDC, &clip, "camrect2" ); pDocView->OnDraw( pDC, clip.ToOil(pDocView) ); } } #endif } // TRACE( _T("Leaving ScreenView::OnDraw\n")); }

void ScreenView::OnDropFiles (  HDROP  hDropInfo  )  [protected]

Respond to files being dropped onto the view window. It sets up the current document and docview, and passes control on to the OpDroppedFile operation. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 29/07/94 Parameters: hDropInfo  - handle to information about drag event. [INPUTS] See also: OpDroppedFile Definition at line 4134 of file scrvw.cpp. { #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) #ifdef STANDALONE // Force Viewer to 'Load' rather than Import GetMainFrame()->OnDropFiles(hDropInfo); #else // Set the correct docivew (and hence document) pDocView->SetCurrent(); // Invoke the dropped files operation OpDescriptor *pOpDesc = OpDescriptor::FindOpDescriptor(OPTOKEN_DROPPEDFILE); pOpDesc->Invoke((OpParam *) hDropInfo); // Clean up DragFinish(hDropInfo); #endif #endif }

void ScreenView::OnFilePrint (   )  [virtual]

Reimplemented from CCamView.

void ScreenView::OnFilePrintPreview (   )  [virtual]

Simply makes CView::OnFilePrintPreview() have public scope. Used by the menu system. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Public See also: CView::OnFilePrintPreview(); CCamView::OnFilePrint() Reimplemented from CCamView. Definition at line 4199 of file scrvw.cpp. { SetCurrentStates(); CCamView::OnFilePrintPreview(); }

afx_msg LRESULT ScreenView::OnFrameMove (  WPARAM  x, LPARAM  y )  [protected]

void ScreenView::OnHScroll (  UINT32  nSBCode, UINT32  nPos, CScrollBar *  pScrollBar )  [protected]

The framework calls this member function when the user clicks a window's horizontal scroll bar. Author: Marc_Power (Xara Group Ltd) <camelotdev@xara.com> Date: 6/10/95 Definition at line 4727 of file scrvw.cpp. { if(HScrollBar) { HScrollBar->HandleScrollMessage(nSBCode, nPos); } }

void ScreenView::OnInitialUpdate (   )  [protected, virtual]

Reimplemented from CCamView. Definition at line 1005 of file scrvw.cpp. { // Set up current etc. SetCurrentStates(); // Check if this view is being created by LoadAppWindowState at the start. If it is // then pick up the ViewState object ready-made by LoadAppWindowState and set // this view according to that. if (pReadyMadeViewState != NULL) { // Set the flags saved in temp. storage in the ViewState in the corresponding // DocView. DocView* pdv = GetDocViewPtr(); ERROR3IF(pdv == NULL, "Null DocView* in ScreenView::OnInitialUpdate"); // Deallocate the old ViewState and set the new. delete SetViewState(pReadyMadeViewState); // Set these flags as well in the DocView. pdv->ViewFlags.GridShow = pReadyMadeViewState->_GridShow; pdv->ViewFlags.GridSnap = pReadyMadeViewState->_GridSnap; pdv->ViewFlags.ObjectsSnap = pReadyMadeViewState->_ObjectsSnap; pdv->ViewFlags.MagObjectsSnap = pReadyMadeViewState->_MagObjectsSnap; pdv->ViewFlags.PrintBorderShow = pReadyMadeViewState->_PrintBorderShow; pdv->ViewFlags.LogicalView = pReadyMadeViewState->_LogicalView; pdv->ViewFlags.GuidesSnap = pReadyMadeViewState->_GuidesSnap; pdv->ViewFlags.GuidesShow = pReadyMadeViewState->_GuidesShow; // Make sure we set this view from the view-state, not the other way around. pReadyMadeViewState = NULL; Status->IsNewView = FALSE; } // Force the DocView to set the work area extent. pDocView->ViewStateChanged(); PORTNOTETRACE("other","ScreenView::OnInitialUpdate - code removed"); #ifndef EXCLUDE_FROM_XARALX if(HScrollBar&&VScrollBar) { // Calculate the scroller page & line sizes, and its range, and make sure the // work area extent is updated. FIXED16 PixelWidth, PixelHeight; pDocView->GetPixelSize(&PixelWidth, &PixelHeight); XLONG x1 = CurrentSize.GetWidth() * PixelWidth; XLONG x2 = CurrentSize.GetHeight() * PixelHeight; HScrollBar->SetPageSize(x1); VScrollBar->SetPageSize(x2); HScrollBar->SetLineSize(x1 / xlong(10) + xlong(1)); VScrollBar->SetLineSize(x2 / xlong(10) + xlong(1)); } #endif // Either make this view conform to the ViewState, or update the ViewState with // information about this view, depending on whether the view is new or (re)loaded. if (Status->IsNewView) { SetViewStateFromThis(); pDocView->OnNewView(); // give the DocView a shot } else { SetThisFromViewState(); pDocView->OnLoadedView(); // let kernel have its say } PORTNOTE("other","ScreenView::OnInitialUpdate - code removed") #ifndef EXCLUDE_FROM_XARALX // RALPH if (GetParentFrame()) { #if (_OLE_VER >= 0x200) // In OLE builds only do this for non-embedded docs, as OnShowDocument will handle it // for embedded docs. if (!GetDocument()->IsServer()) #endif { // Apply preferences. To begin, maximise this view if it is the only one around. BOOL fAppIsIcon = GetMainFrame()->IsIconic(); if (HowMany() == 1) { // This flag is TRUE during workspace restoration of more than one doc. We don't // want to maximise any views if its TRUE. extern BOOL fDontMaximiseViews; if (ZoomSingleView && !fAppIsIcon && !fDontMaximiseViews) ((CMDIChildWnd*) GetParentFrame())->MDIMaximize(); } else { // Otherwise, if a view is already maximised, un-maximise it so that this // view is visible. if (UnzoomOnNewView || fAppIsIcon) { // Find out the active view, which must be the one maximised, if any are. BOOL fIsMaxed; CMDIFrameWnd* pMainWnd = ((CMDIChildWnd*) GetParentFrame())->GetMDIFrame(); ENSURE(pMainWnd, "No MDI frame window in ScreenView::OnShowWindow!"); CMDIChildWnd* pMaxiWnd = pMainWnd->MDIGetActive(&fIsMaxed); // If it is maximised then restore it. if (fIsMaxed && pMaxiWnd != NULL) { wxView* pv = pMaxiWnd->GetActiveView(); if (pv && pv->GetDocument() && ((CCamDoc*) pv->GetDocument())->IsUntouched()) { TRACEUSER( "JustinF", _T("MDI Restore in ScreenView::OnInitialUpdate\n")); pMaxiWnd->MDIRestore(); } } } } } } #ifdef _DEBUG else { TRACEUSER( "JustinF", _T("\t- no parent frame in ScreenView::OnInitialUpdate\n")); } #endif #endif // Initialise the OLE selection (TODO: remove this when selection model code // is written). #if (_OLE_VER >= 0x200) m_pSelection = 0; #endif // Make sure the render window is repainted and inform the kernel that something // has happened. // InvalidateView(); pDocView->ViewStateChanged(); // Allow the base class to do it's OnInitialUpdate stuff last, because it just // calls OnUpdate. // CCamView::OnInitialUpdate(); // Indicate that we have set the position, size, focus etc so OnActivateView is safe // to update the HasFocus fields of ViewStates. fSetupDone = TRUE; #if (_OLE_VER >= 0x200) // Check if the document wants to zoom to the page. This is the best place to // do this as everything should now be stable. LPCTSTR lpcszZoomOp = GetDocument()->GetInitialZoom(); if (lpcszZoomOp) { // Remember the old prev. zoom setting. INT32 nPrev; FIXED16 fxPrev; WorkCoord wcPrev; nPrev = pDocView->GetPrevZoomIndex(); fxPrev = pDocView->GetPrevZoomScale(); wcPrev = pDocView->GetPrevZoomOffset(); // There is, so zoom it to show the new page bounds. Set-up the kernel. DocView* pOldCurrent = DocView::GetCurrent(); pDocView->SetCurrent(); // Perform the Zoom-to-Page Operation (it's non-undo-able). OpDescriptor* pOp = OpDescriptor::FindOpDescriptor((LPTSTR) lpcszZoomOp); ERROR3IF(!pOp, "Can't find the Zoom Operation in ScreenView::OnInitialUpdate"); pOp->Invoke(0); // Restore the old prev. zoom setting. pDocView->SetPrevZoomIndex(nPrev); pDocView->SetPrevZoomScale(fxPrev); pDocView->SetPrevZoomOffset(wcPrev); } #endif }

void ScreenView::OnInsertObject (   )  [protected]

"Creates an embedded OLE object with a type-name retrieved from the user" - currently unimplemented. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: ScreenView::IsSelected() Definition at line 4285 of file scrvw.cpp. { SetCurrentStates(); #if (_OLE_VER >= 0x200) // OLE 2.0+ default implementation. // Invoke the standard Insert Object dialog box to obtain information for a new // CCamCntrItem object. COleInsertDialog dlg; if (dlg.DoModal() != IDOK) return; BeginBusyCursor(); CCamCntrItem* pItem = NULL; TRY { // Create new item connected to this document. CCamDoc* pDoc = GetDocument(); ASSERT_VALID(pDoc); pItem = new CCamCntrItem(pDoc); ASSERT_VALID(pItem); // Initialize the item from the dialog data. if (!dlg.CreateItem(pItem)) AfxThrowMemoryException(); // any exception will do ASSERT_VALID(pItem); // If item created from class list (not from file) then launch // the server to edit the item. if (dlg.GetSelectionType() == COleInsertDialog::createNewItem) pItem->DoVerb(OLEIVERB_SHOW, this); ASSERT_VALID(pItem); // As an arbitrary user interface design, this sets the selection // to the last item inserted. // TODO: reimplement selection as appropriate for your application m_pSelection = pItem; // set selection to last inserted item pDoc->UpdateAllViews(NULL); } CATCH(CException, e) { if (pItem != NULL) { ASSERT_VALID(pItem); pItem->Delete(); } AfxMessageBox(_R(IDP_FAILED_TO_CREATE)); } END_CATCH EndBusyCursor(); #else // OLE 1.0 default implementation. wxString strTypeName; #if (_MFC_VER < 0x300) if (!AfxOleInsertDialog(strTypeName)) return; // no OLE class selected #endif TRACE( _T("Trying to Insert OLE item with type '%s'\n"), (const char*)strTypeName); // TODO: create an embedded OLE object with that class name char szT[300]; wsprintf(szT, "Listen pal - don't do that again! This " "particular function is not completely implemented.\n" "You must add code to create a COleClientItem with a " "type name of '%s'. See ScreenView::OnInsertObject in\n" "CAMVW.CPP for more info.", (LPCSTR)strTypeName); AfxMessageBox(szT); #endif }

void ScreenView::OnLButtonDblClk (  wxMouseEvent &  event  )  [protected]

Passes a left-button double-click to ScreenView::HandleDragEvent(). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor. -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::HandleDragEvent() Reimplemented from CCamView. Definition at line 4048 of file scrvw.cpp. { // Support quad clicks wxRect ClickBounds( LastDoubleClickPos.x-LocalEnvironment::GetXMouseDoubleClickMove(), LastDoubleClickPos.y-LocalEnvironment::GetYMouseDoubleClickMove(), LastDoubleClickPos.x+LocalEnvironment::GetXMouseDoubleClickMove(), LastDoubleClickPos.y+LocalEnvironment::GetYMouseDoubleClickMove()); MonotonicTime ThisClickTime( event.GetTimestamp() ); MonotonicTime ClickGap(LocalEnvironment::GetMouseDoubleClickDelay()); // Is click within allowed movement rectangle and permitted time delay INT32 TimeDelay = (ThisClickTime - TimeOfLastClick); if (ClickBounds.Inside( event.GetPosition() ) && (TimeDelay <= (INT32)ClickGap)) ThisDoubleIsQuad = TRUE; else ThisDoubleIsQuad = FALSE; HandleDragEvent(MK_LBUTTON, event, CLICKTYPE_DOUBLE); TimeOfLastClick.Sample(); LastDoubleClickPos = event.GetPosition(); }

void ScreenView::OnLButtonDown (  wxMouseEvent &  event  )  [protected]

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. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor. -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::HandleDragEvent() Reimplemented from CCamView. Definition at line 3366 of file scrvw.cpp. { #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // WEBSTER - markn 25/4/97 // No pen stuff required in Webster // Taken out by vector stroking code Neville 2/10/97 #ifdef VECTOR_STROKING // Setup pressure if pen active (Camelot.GetPressurePen())->CheckMouseMessage(WM_LBUTTONDOWN, point); #endif // VECTOR_STROKING #endif // Support triple clicks wxRect ClickBounds( LastDoubleClickPos.x - LocalEnvironment::GetXMouseDoubleClickMove(), LastDoubleClickPos.y - LocalEnvironment::GetYMouseDoubleClickMove(), LocalEnvironment::GetXMouseDoubleClickMove() * 2, LocalEnvironment::GetYMouseDoubleClickMove() * 2 ); MonotonicTime ThisClickTime( event.GetTimestamp() ); MonotonicTime ClickGap(LocalEnvironment::GetMouseDoubleClickDelay()); // Is click within allowed movement rectangle and permitted time delay INT32 TimeDelay = (ThisClickTime - TimeOfLastClick); if( ClickBounds.Inside( event.GetPosition() ) && ( TimeDelay <= (INT32)ClickGap ) ) ThisSingleIsTriple = TRUE; else ThisSingleIsTriple = FALSE; // Deal with the click HandleDragEvent( MK_LBUTTON, event, CLICKTYPE_SINGLE ); TimeOfLastClick.Sample(); }

void ScreenView::OnLButtonUp (  wxMouseEvent &  event  )  [protected]

Passes the event on to HandleButtonUp(). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::OnLButtonDown(); ScreenView::GetClickMods(); DocView::DragFinished(); ScreenView::HandleButtonUp() Reimplemented from CCamView. Definition at line 3974 of file scrvw.cpp. { HandleButtonUp(MK_LBUTTON, event); }

void ScreenView::OnMButtonDblClk (  wxMouseEvent &  event  )  [protected]

Passes a middle-button double-click to ScreenView::HandleDragEvent(). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor. -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::HandleDragEvent() Reimplemented from CCamView. Definition at line 4089 of file scrvw.cpp. { HandleDragEvent(MK_MBUTTON, event, CLICKTYPE_DOUBLE); }

void ScreenView::OnMButtonDown (  wxMouseEvent &  event  )  [protected]

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. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor. -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::HandleDragEvent() Reimplemented from CCamView. Definition at line 3419 of file scrvw.cpp. { #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // WEBSTER - markn 25/4/97 // No pen stuff required in Webster // Taken out by vector stroking code Neville 2/10/97 #ifdef VECTOR_STROKING (Camelot.GetPressurePen())->CheckMouseMessage(WM_MBUTTONDOWN, point); #endif // VECTOR_STROKING #endif HandleDragEvent(MK_MBUTTON, event, CLICKTYPE_SINGLE); }

void ScreenView::OnMButtonUp (  wxMouseEvent &  event  )  [protected]

Passes the event on to HandleButtonUp(). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor. -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::OnMButtonDown(); ScreenView::GetClickMods(); DocView::DragFinished(); ScreenView::HandleButtonUp() Reimplemented from CCamView. Definition at line 3999 of file scrvw.cpp. { HandleButtonUp(MK_MBUTTON, event); }

afx_msg INT32 ScreenView::OnMouseActivate (  wxWindow *  pDesktopWnd, UINT32  nHitTest, UINT32  nMessage )  [protected]

void ScreenView::OnMouseMove (  wxMouseEvent &  event  )  [protected]

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). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor. -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::HandleDragEvent(); DocView::DragPointerMove(); ScreenView::GetClickMods(); ScreenView::HandleDragScrolling(); DocView::OnMouseMove() Reimplemented from CCamView. Definition at line 3498 of file scrvw.cpp. { // Ignore if system is disabled if (CCamApp::IsDisabled()) return; // If the system is disabled, ignore // Only respond to real mouse move messages if (event.GetPosition()==CurrentMousePos) return; // Ignore mouse moves if we're not the foreground window. if (pDocView != DocView::GetSelected()) { return; } UINT32 nFlags = ClickModifiers::SynthesizeMouseEventFlags(event); //PORTNOTE("other","Remove StatusLine related code") //#ifndef EXCLUDE_FROM_XARALX StatusLine* pStatusLine=NULL; // flag that the StatusLine's mouse position field needs updating #ifndef RALPH pStatusLine=GetApplication()->GetpStatusLine(); if (pStatusLine) pStatusLine->FlagMousePosNeedsUpdating(); #endif //#endif SetCurrentStates(); PORTNOTE("other","Remove PeekMessage related code") #ifndef EXCLUDE_FROM_XARALX // Only discard mouse move messages if the initiator of the drag has requested this. if (!DragKeepAccuracy) { // Due to problems with auto-repeat on modifier keys, we can lag a long way behind // with mouse messages, so we discard all except the most recent mouse move messages. // However we stop discarding mouse move messages if we come across any other mouse // messages such as button up/down events. MSG Msg; BOOL FoundMsg = FALSE; for(;;) { // We have to test that the window handles match because of a bug in PeekMessage (we // get messages which aren't for the window we specified, strangely). if (::PeekMessage(&Msg, m_hWnd, WM_MOUSEFIRST, WM_MOUSELAST, PM_NOREMOVE) && (m_hWnd == Msg.hwnd) && (Msg.message == WM_MOUSEMOVE)) { // Found a mouse move message on the queue... // Remember it then discard it. nFlags = (UINT32) Msg.wParam; // Have to cast to INT8 so we get correct sign-extension. point.x = (INT8) LOWORD(Msg.lParam); point.y = (INT8) HIWORD(Msg.lParam); // Discard the message PeekMessage(&Msg, m_hWnd, WM_MOUSEMOVE, WM_MOUSEMOVE, PM_REMOVE); FoundMsg = TRUE; } else { // Either: there are no messages, or it's not for our window, or it's a mouse // event which is not a mouse *move* event - whatever it is, stop looking // for mouse events. break; } } // If we found any other mouse messages, use the data from the most recent one and // ignore the others. if (FoundMsg) { ENSURE(m_hWnd == Msg.hwnd, "Bad message in OnMouseMove"); nFlags = (UINT32) Msg.wParam; point.x = (INT8) LOWORD(Msg.lParam); point.y = (INT8) HIWORD(Msg.lParam); } } // Slow mouse reponse due to key auto-repeat msgs? // // We could be experiencing delayed mouse move messages due to the message // queue getting flooded with key auto-repeat msgs. // // To overcome this, we remove all mouse move messages, keeping only the most // recent msg's coords & flags. // // Stripping the message cue in this way means we get less mouse moves to drag handlers, hence less accurate // mouse move data. But, as we only do this if we get an auto-repeated key stroke, accuracy should not be // a problem, even for the freehand tool. Freehand drags have two key modifiers (Alt for straught line and // Shift for rubbing out) that only require the latest mouse move event MSG Msg; // Has there been a key msg during the mouse move? if (::PeekMessage(&Msg, m_hWnd, WM_KEYFIRST, WM_KEYLAST, PM_NOREMOVE)) { // Have a look at the key msg (use KeyPressSysMsg to turn the msg into a system-independant format) KeyPressSysMsg KeySysMsg(&Msg); // Is the key msg an auto-repeated key press (i.e. previously down)? if (KeySysMsg.IsValid() && KeySysMsg.PrevDown) { // Auto repeat key msg found, so get the latest mouse move msg // Note: We don't remove the msg from the queue, it may need to be processed elsewhere (e.g. button-ups) while (::PeekMessage(&Msg, m_hWnd, WM_MOUSEFIRST, WM_MOUSELAST, PM_NOREMOVE)) { // Is the mouse msg a mouse move msgs? if (Msg.message == WM_MOUSEMOVE) { // Found a mouse move message on the queue so remember it nFlags = (UINT32) Msg.wParam; // Have to cast to INT8 so we get correct sign-extension. point.x = (INT8) LOWORD(Msg.lParam); point.y = (INT8) HIWORD(Msg.lParam); // Remove the mouse move msg, and get the next mouse msg in the queue ::PeekMessage(&Msg, m_hWnd, WM_MOUSEFIRST, WM_MOUSELAST, PM_REMOVE); } else { // We have got a mouse msg that's not a mouse move msg, so break out of 'while' loop // This could be a button-up msg, in which case we should stop looking for // mouse moves as they may be irrelevent to the current drag break; } } } } #endif #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // WEBSTER - markn 25/4/97 // No pen stuff required in Webster // Taken out by vector stroking code Neville 2/10/97 #ifdef VECTOR_STROKING // Now check the Mouse Message to see if it has any pressure information (Camelot.GetPressurePen())->CheckMouseMessage(WM_MOUSEMOVE, point); #endif // VECTOR_STROKING #endif // Set the DocView (and Document) // pDocView->SetCurrent(); // Find out which buttons/keys are down. GetClickMods(event, &LastClickMods); // Are we dragging at the moment? if (pCurrentDragOp) { // Yes, but just check that the drag isn't "paused" while we do an OLE drag outside the window if (GetCanvas()->GetCapture() == GetCanvas()) { WinCoord point; event.GetPosition( &point.x, &point.y ); // Send an on-going drag event to the kernel. pDocView->DragPointerMove(pCurrentDragOp, point.ToOil(pDocView, TRUE), LastClickMods); // Check if we need to scroll this view. HandleDragScrolling(point); } } else { // We are not dragging at the moment, but are we about to start a drag? If the // last mouse event was a single click, the same buttons are down, and the mouse // has either moved (3 or more), then a drag is beginning. WinCoord point; event.GetPosition( &point.x, &point.y ); INT32 dx = point.x - LastClickPoint.x; INT32 dy = point.y - LastClickPoint.y; INT32 dz2 = (dx * dx) + (dy * dy); if ((nFlags & FirstClickButton) && (dz2 >= (DragLatency * DragLatency))) { // Inform the kernel that a drag is starting. wxMouseEvent KernelEvent( event ); KernelEvent.m_x = LastClickPoint.x; KernelEvent.m_y = LastClickPoint.y; HandleDragEvent(FirstClickButton, KernelEvent, CLICKTYPE_DRAG); } else { // We are not dragging, just moving the mouse around, so pass the position // of the mouse to the tool, giving it an opportunity to set the cursor etc. pDocView->OnMouseMove( point.ToOil(pDocView, TRUE), LastClickMods); } } // Remember the last position of the mouse passed on to the kernel. The position // passed on any subsequent DragPointerIdle events must be the same as this! CurrentMousePos = event.GetPosition(); #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // if status line has not already been updated by someone calling CSnap::Snap(), call // CSnap::Snap(), snapping to grid only, to update status line (and ruler mouse followers) if (pStatusLine && pStatusLine->MousePosNeedsUpdating()) { OilCoord OilPos=((WinCoord*)&point)->ToOil(pDocView, TRUE); DocCoord DocPos(0,0); Spread* pSpread=pDocView->OilToSpreadCoord(OilPos,&DocPos); if (pSpread) pDocView->Snap(pSpread,&DocPos,TRUE,TRUE); } #endif }

void ScreenView::OnMouseWheel (  wxMouseEvent &  event  )  [protected]

Scope: Protected. Author: Priestley (Xara Group Ltd) <camelotdev@xara.com> Date: 25/10/2000 Reimplemented from CCamView. Definition at line 3471 of file scrvw.cpp. { HandleMouseWheelEvent( event ); }

void ScreenView::OnPaint (   )  [protected]

Handles WM_PAINT messages for the ScreenView window. As the window is entirely covered by child windows, which know how to paint themselves, this function simply validates its (invisible) client area, removing the paint message. No drawing of any kind is done. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd Definition at line 1513 of file scrvw.cpp. { try { Error::RenderThreadIn(); wxPaintDC dc(this); // this validates the client area Error::RenderThreadOut(); } catch( CResourceException e ) { ENSURE(FALSE, "Resource exception in ScreenView::OnPaint!\n"); } }

BOOL ScreenView::OnPreparePrinting (  CPrintInfo *  pInfo  )  [virtual]

Current just returns that value of CView::DoPreparePrinting(). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: by the wonderful AppWizard Parameters: -  [INPUTS] Fills  the passed CPrintInfo with some stuff. [OUTPUTS] Returns: TRUE if successful preparation for printing. Errors: - Scope: Public See also: CView::DoPreparePrinting() Definition at line 1730 of file scrvw.cpp. { #ifndef STANDALONE if (!CCPrintDialog::OnPreparePrinting(pInfo,pDocView->GetDoc())) ERROR2(FALSE,"Unable to initialise the customized print dialog"); // default preparation // BOOL Result = CCamView::DoPreparePrinting(pInfo); // if (!Result) // return FALSE; // Check because brainless CView only checks for valid DC in debug builds - handy eh? NOT! if (pInfo->m_pPD->m_pd.hDC == NULL) { ERROR1(FALSE,_R(IDE_NULL_PRINTDC)); //ERROR2(FALSE, "No valid DC returned by print dialog!"); } // Get ourselves a print view and attach it to this CamView. // NB. Must be after the user has clicked OK on print dialog, as we set up // anti-aliasing etc. in PrintView constructor. if (pPrintView != NULL) { delete pPrintView; pPrintView = NULL; ERROR2(FALSE, "OnPreparePrinting(): we already have a PrintView!"); } pPrintView = new PrintView(pDocView->GetDoc()); if (pPrintView == NULL) ERROR2(FALSE, "Not enough memory to create PrintView object"); if (!pPrintView->ConnectToOilView(this)) { delete pPrintView; pPrintView = NULL; ERROR2(FALSE, "Unable to attach PrintView to CamView."); } #endif // OK if we got this far. return TRUE; }

void ScreenView::OnRButtonDblClk (  wxMouseEvent &  event  )  [protected]

Same as ScreenView::OnLButtonDblClk(), bit for the right button. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::OnLButtonDblClk() Reimplemented from CCamView. Definition at line 4113 of file scrvw.cpp. { HandleDragEvent(MK_RBUTTON, event, CLICKTYPE_DOUBLE); }

void ScreenView::OnRButtonDown (  wxMouseEvent &  event  )  [protected]

Same as for ScreenView::OnLButtonDown(), but for the right mouse button. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor. -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::HandleDragEvent(); ScreenView::OnLButtonDown() Reimplemented from CCamView. Definition at line 3448 of file scrvw.cpp. { #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // WEBSTER - markn 25/4/97 // No pen stuff required in Webster // Taken out by vector stroking code Neville 2/10/97 #ifdef VECTOR_STROKING (Camelot.GetPressurePen())->CheckMouseMessage( WM_RBUTTONDOWN, event.GetPosition() ); #endif // VECTOR_STROKING #endif HandleDragEvent(MK_RBUTTON, event, CLICKTYPE_SINGLE); }

void ScreenView::OnRButtonUp (  wxMouseEvent &  event  )  [protected]

Same as ScreenView::OnLButtonUp(), but for the right mouse button. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: Flags  describing which buttons & keys were down when the message was sent; [INPUTS] the coordinates of the mouse cursor. -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: class CRendWnd; ScreenView::OnRButtonDown(); ScreenView::GetClickMods(); DocView::DragFinished(); ScreenView::HandleButtonUp() Reimplemented from CCamView. Definition at line 4024 of file scrvw.cpp. { HandleButtonUp(MK_RBUTTON, event); }

LRESULT ScreenView::OnRenderView (  WPARAM  wp, LPARAM  lp )  [protected]

Responds to a WM_PAINT message sent to the RendWnd window object. Effectively tricks MFC into painting the RendWnd as if it was a CView window, not a child of a CView - calls CView::OnPrepareDC() and ScreenView::OnDraw(). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  pointer to a CPaintDC, cast into an LPARAM. The WPARAM is not used. [INPUTS] -  [OUTPUTS] Returns: Returns 0, indicating to Windows that the message was successfully processed. Errors: - Scope: Protected See also: class CRendWnd; CRenderWnd::OnPaint(); ScreenView::OnDraw(); Reimplemented from CCamView. Definition at line 1550 of file scrvw.cpp. { CPaintDC* pDC = (CPaintDC*) lp; OnPrepareDC(pDC); OnDraw(pDC); return 0; }

LRESULT ScreenView::OnScrollerEvent (  WPARAM  redraw, LPARAM  barptr )  [protected]

This message is sent by the scroll bars in response to an earlier call to ScreenView::SetScrollOffset(). The scroll offset is read from the scroll bars and the ScrollPosition field of the ViewState is updated accordingly. If the WPARAM parameter is TRUE then the client area is repainted via a call to ScreenView::ScrollTo(). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  boolean, cast to a WPARAM, which indicates whether ScreenView should update [INPUTS] the client area in response to this message. The LPARAM is not used. -  [OUTPUTS] Returns: Returns 0, indicating to Windows that the message has been processed successfully. Errors: - Scope: Protected See also: ScreenView::SetScrollOffset(); ScreenView::ScrollTo(); CScroller::MoveThumb() Definition at line 2137 of file scrvw.cpp. { SetCurrentStates(); if (Status && fSetupDone) { WorkCoord temp; GetScrollOffset(&temp); Status->SetScrollPos(temp); if (redraw) ScrollTo( Status->GetScrollPos() ); } return 0; }

BOOL ScreenView::OnSetCursor (  wxWindow *  pWnd, UINT32  nHitTest, UINT32  nMessage )  [protected]

Calls the kernel DocView object to set the cursor for this ScreenView. Scope: Protected. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 14 Oct 93 Parameters: pWnd  points to the window that contains the cursor; [INPUTS] "nHitTest" contains a code indicating the part of the window the cursor is over; "nMessage" contains the mouse-message numeric identifier (WM_LBUTTONDOWN etc). Returns: TRUE, ie. the cursor has been set, and no further processing is necessary. FALSE if the cursor has not been set, e.g. this view is not active. See also: DocView::OnSetCursor Definition at line 2222 of file scrvw.cpp. { // Child windows assume responsibility for setting their own cursor. if (pWnd == GetCanvas()) { // Get the kernel to do the business for the view display .... ENSURE(pDocView != 0, "No link to kernel DocView in ScreenView::OnSetCursor!\n"); SetCurrentStates(); pDocView->OnSetCursor(); return TRUE; } else if (pWnd == Corner) return Corner->OnSetCursor(Corner, nHitTest, nMessage); return FALSE; }

void ScreenView::OnSize (  wxSizeEvent &  event  )  [protected]

Moved down to ScreenCamView. Author: Chris_Parks (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  flag indicating whether the window is maximised, minimised [INPUTS] etc., the width and height of the ScreenView client area. -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: CScroller::CalcPosFromParentClient(); CScroller::SetPageSize(); CScroller::SetLineSize(); class CRendWnd; class CScrollerCorner; struct ViewState; DocView::ViewStateChanged() Reimplemented from CCamView. Reimplemented in ScreenCamView. Definition at line 1365 of file scrvw.cpp. { }

void ScreenView::OnTimer (  UINT32  nIDEvent  )  [protected]

Called when a key is pressed, so we can do something with it. It is currently only used to adjust the Pretend Pen Pressure. THIS CODE HAS BEEN COMMENTED OUT UNTIL THE NEW KEYBOARD SYSTEM IS FULLY OPERATIONAL!! 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. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: The  elapsed timer's numeric identifier (not used). [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: ScreenView::HandleDragEvent(); DocView::DragPointerMove(); ScreenView::GetClickMods(); Definition at line 3805 of file scrvw.cpp. { // Ignore if system is disabled if (CCamApp::IsDisabled()) return; // If the system is disabled, ignore // This window should never get a timer event that does not occur between calls to // StartDrag() and EndDrag(). // ENSURE(pCurrentDragOp != 0, "ScreenView::StartDrag: pCurrentDragOp is null"); // Find out which keys/buttons are being held down at the moment. The mouse buttons // are more difficult, as they may have been swapped. UINT32 nFlags = ClickModifiers::SynthesizeMouseEventFlags(); SetCurrentStates(); if (pCurrentDragOp == NULL) { // We are not dragging at the moment, so check for a time-out condition to // start a drag: // If a mouse button is down, and the timer has expired, then start a drag. if (LastClickType!=CLICKTYPE_NONE && (nFlags & (MK_LBUTTON|MK_MBUTTON|MK_RBUTTON)) && DragTimer.Elapsed(DragDelay) && GetCurrentMousePos(NULL) ) { // Inform the kernel that a drag is starting. HandleDragEvent(FirstClickButton, nFlags, LastClickPoint, CLICKTYPE_DRAG); } } else { // If we're doing an OLE drag and drop operation, then our DragOperation is still // active, but we have lost the Mouse Capture, so we should not update anything. // If the user drags back into our view window, the OLE drag will be shut down // and we will be given back our mouse capture so we can continue as if nothing // had happened. This just stops us scrolling while the OLE system is in charge! if (GetCanvas()->GetCapture() == GetCanvas()) { // Check if we need to scroll the screen . . . HandleDragScrolling(CurrentMousePos); // The above call may have aborted the current DragOp, so we must check if it is NULL if (pCurrentDragOp != NULL) { // Now "fake" a mouse event for the kernel . . . GetClickMods(nFlags, &LastClickMods); pDocView->DragPointerIdle(pCurrentDragOp, ((WinCoord*)&CurrentMousePos)->ToOil(pDocView, TRUE), LastClickMods); } } else { // We don't own the capture - but if the user was OLE dragging and has dragged back into our // view window, then the OLE drag will have been cancelled, and we need to recapture the // mouse so that we can continue processing the drag as if nothing happened. Our OLE DropSource // will set our OLERecaptureMouse flag if it cancels itself and wishes us to continue... if (OLERecaptureMouse) { GetCanvas()->SetCapture(); OLERecaptureMouse = FALSE; // Only capture it back once! } } } }

void ScreenView::OnUpdate (  wxView *  sender, wxObject *  hint = (wxObject*)NULL )  [protected, virtual]

Called when the view must first display the document. Moves this view/frame to the position given in the ViewState object. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 19 Jan 1994 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Protected See also: ScreenView::SetThisFromViewState; ScreenView::SetViewStateFromThis; DocView::ViewStateChanged Reimplemented from CCamView. Definition at line 990 of file scrvw.cpp. { if ( sender==NULL && !fInitialUpdate ) { OnInitialUpdate(); fInitialUpdate = true; } CCamView::OnUpdate(sender,hint); }

void ScreenView::OnVScroll (  UINT32  nSBCode, UINT32  nPos, CScrollBar *  pScrollBar )  [protected]

The framework calls this member function when the user clicks a window's vertical scroll bar. Author: Marc_Power (Xara Group Ltd) <camelotdev@xara.com> Date: 6/10/95 Definition at line 4744 of file scrvw.cpp. { if(VScrollBar) { VScrollBar->HandleScrollMessage(nSBCode, nPos); } }

BOOL ScreenView::PrintPaper (  wxDC *  pPrintDC, CCPrintInfo *  pPrintInfo, PrintControl *  pPrintControl )  [protected]

Reimplemented from CCamView.

BOOL ScreenView::ReadViewPrefs (   )  [static]

Tries to load preferences for ScreenView, creating them with default values if they don't exist. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 26/11/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the .INI file settings were loaded (or created) successfully. Errors: - See also: Application::DeclareSection; Application::DeclarePref Reimplemented from CCamView. Definition at line 489 of file scrvw.cpp. { #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // Declare and load the .INI file settings. BOOL ok = Camelot.DeclareSection(TEXT("Mouse"), 10) && Camelot.DeclarePref(TEXT("Mouse"), TEXT("DragLatency"), &ScreenView::DragLatency, 1, 10) && Camelot.DeclarePref(TEXT("Mouse"), TEXT("DragDelay"), &DragDelay, 100, 2000) && Camelot.DeclareSection(TEXT("WindowFurniture"), 10) && Camelot.DeclarePref(TEXT("WindowFurniture"), TEXT("PropScrollers"), &ScreenView::PropScrollersOn, FALSE, TRUE) && Camelot.DeclarePref(TEXT("WindowFurniture"), TEXT("Scrollers Visibilty State"), &ScreenView::DefaultScrollersState, FALSE, TRUE)&& Camelot.DeclarePref(TEXT("WindowFurniture"), TEXT("Rulers Visibilty State"), &ScreenView::DefaultRulersState, FALSE, TRUE) && Camelot.DeclareSection(TEXT("Windows"), 10) && Camelot.DeclarePref(TEXT("Windows"), TEXT("UnzoomOnNewView"), &ScreenView::UnzoomOnNewView, FALSE, TRUE) && Camelot.DeclarePref(TEXT("Windows"), TEXT("ZoomSingleView"), &ScreenView::ZoomSingleView, FALSE, TRUE); return ok; #else return TRUE; #endif }

void ScreenView::RecaptureMouseOnNextUpdate (  void   )

Called by the OLE drag & drop system (CCamDropSource::QueryContinueDrag, winoil.cpp) when dragging a selection - if the mouse pointer goes outside the view, the selection drag is "paused", and an OLE drag is started. If the pointer comes back into our view, we cancel the OLE drag and resume the selector drag - the only thing we need to do to resume is to reclaim the mouse capture (but we must do it on the next idle to ensure that we get & keep the capture, so we flag it here and fix it up in OnTimer, above). Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: ?/10/96 The other thing we must now do is to XOR the dragged objects once to restore them to screen (as we now hide the XOR when you drag out of the window) Reimplemented from CCamView. Definition at line 3895 of file scrvw.cpp. { // Flag the fact that we must recapture the mouse OLERecaptureMouse = TRUE; Spread *pSpread = pDocView->FindEnclosingSpread(((WinCoord*)&CurrentMousePos)->ToOil(pDocView, TRUE)); if (pSpread != NULL) { // Get the DocView's viewport, in Spread Coords, because we have to supply a DocRect to // this stupid routine which won't let us pass a NULL pointer in to just redraw // it all, depsite the fact that all the functions it calls will allow it. Grrr. // (And using the Spread's bounding rect doesn't work because its bounding rect is in // chapter coords, not spread coords. Tread carefully... DocRect ClipRect = pDocView->GetDocViewRect(pSpread); pSpread->DocCoordToSpreadCoord(&ClipRect); if (pCurrentDragOp != NULL) pCurrentDragOp->RenderDragBlobs(ClipRect, pSpread, pDocView->GetCurrentSolidDragState()); } }

void ScreenView::ScrollTo (  const WorkCoord &  offset  )  [protected]

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. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: The  position, in WorkCoords, that the top-left corner of the view is to [INPUTS] move to. -  [OUTPUTS] Returns: - Errors: - Scope: Private See also: ScreenView::SetScrollPos() Reimplemented from CCamView. Definition at line 1865 of file scrvw.cpp. { PORTNOTETRACE("other","ScreenView::ScrollTo - do nothing"); #ifndef EXCLUDE_FROM_XARALX // Calculate the difference between where we are and where we want to be. Notice // the asymmetry in the calculations, to account for the Windows coordinate origin // being in the top-left, not the bottom-left. FIXED16 PixelWidth, PixelHeight; pDocView->GetPixelSize(&PixelWidth, &PixelHeight); INT32 dx = ((offset.x - OldOffset.x) / PixelWidth.MakeLong() ); INT32 dy = ((OldOffset.y - offset.y) / PixelHeight.MakeLong() ); if (dx == 0 && dy == 0) return; // ZZZ // Scroll part of, or redraw the whole of, the client area. if (Abs(dx) >= CurrentSize.GetRight() || Abs(dy) >= CurrentSize.GetBottom() ) GetCanvas()->Refresh( true ); else GetCanvas()->ScrollWindow(-dx, -dy); // WEBSTER - markn 15/1/97 // No rulers in Webster #ifndef WEBSTER #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) if(Status->RulersVisible) { if(HRuler) HRuler->ScrollRuler(-dx); if(VRuler) VRuler->ScrollRuler(-dy); } #endif #endif // WEBSTER // Remember this scroll offset, which corresponds to what will be drawn on the screen, // and force an immediate repaint of the invalid area. OldOffset = offset; GetCanvas()->UpdateWindow(); #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) // Make sure that the system will update the state of gadgets after this, some of // which may now be "greyed" because what they apply to is no longer visible etc. // This is the best place to put this, as all scroll requests, whether they come // from the user or are internally generated, go through this function. DialogBarOp::SetSystemStateChanged(TRUE); #endif #endif }

static void ScreenView::SetDefaultRulersState (  BOOL  State  )  [inline, static]

Reimplemented from CCamView. Definition at line 326 of file scrvw.h. { DefaultRulersState = State;};

static void ScreenView::SetDefaultScrollersState (  BOOL  State  )  [inline, static]

Reimplemented from CCamView. Definition at line 327 of file scrvw.h. { DefaultScrollersState = State;};

void ScreenView::SetReadyMadeViewState (  ViewState *  pvs  )  [static]

Calls CCamView::Create() to attach a Windows object to the previously constructed C++ object. The view has a standard arrow cursor and a custom icon (_R(IDR_CAMTYPE)). The view is responsible for painting its background itself. The view is initially hidden, until its size and position have been properly set. Call this to set up a view-state object that ScreenView::OnInitialUpdate will use in preference to the one the ScreenView has got already. This is a nasty little "back-door" to changing the creation state of a ScreenView, used by the code that restores docs and views when the app starts. The reason we have to use code like this is that the Camelot doc/view architecture is NOT MFC. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 27/9/95 Parameters: pvs  pointer to a ViewState object [INPUTS] See also: ScreenView::OnInitialUpdate; LoadAppWindowState Definition at line 470 of file scrvw.cpp. { pReadyMadeViewState = pvs; }

void ScreenView::SetScrollerStyle (  BOOL  proportional  )

Allows DocView to change the style - groovy or dull - of ScreenView's scroll bars. Records the setting and calls the appropriate functions of the scroll bar gadgets. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  boolean which if TRUE means that proportional scroll bars should be turned [INPUTS] on, if FALSE that the scroll bars should look normal. -  [OUTPUTS] Returns: - Errors: - Scope: Public See also: ScreenView::GetScrollerStyle(); CScroller::SetProportional() Definition at line 1959 of file scrvw.cpp. { if(!HScrollBar||!VScrollBar) return; ScrollerStyle = proportional; PORTNOTETRACE("other","ScreenView::SetScrollerStyle - do nothing"); #ifndef EXCLUDE_FROM_XARALX HScrollBar->SetProportional(ScrollerStyle); VScrollBar->SetProportional(ScrollerStyle); #endif }

void ScreenView::SetScrollOffset (  const WorkCoord &  pos, BOOL  redraw = TRUE )

Changes the scroll offset in the horizontal and vertical scroll bar. Note that it DOES NOT immediately scroll the client area, which is only done when the scroll bars send back a WM_SCROLLEREVENT message to the ScreenView. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: The  desired scroll offset, in WorkCoords, and a boolean indicating if [INPUTS] TRUE that the view window should be repainted immediately to reflect the change in scroll position. -  [OUTPUTS] Returns: - Errors: - Scope: Public See also: ScreenView::GetScrollOffset; CScroller::SetScrollPos(); ScreenView::OnScrollerEvent() Reimplemented from CCamView. Definition at line 2085 of file scrvw.cpp. { // TRACE( _T("SV::SetScrollOffset(%d, %d)\n"), (INT32)(pos.x), (INT32)(pos.y)); FIXED16 PixelWidth,PixelHeight; pDocView->GetPixelSize(&PixelWidth,&PixelHeight); // INT32 sx = INT32((pos.x-WorkArea.lo.x)/PixelWidth .MakeDouble()); // INT32 sy = INT32((WorkArea.hi.y-pos.y)/PixelHeight.MakeDouble()); // TRACE( _T("Scrolling to (%d, %d)\n"), sx, sy); GetCanvas()->Scroll( INT32((pos.x-WorkArea.lo.x)/PixelWidth .MakeDouble()), INT32((WorkArea.hi.y-pos.y)/PixelHeight.MakeDouble()) ); // Neville 22/8/97 // Somebody is setting the scroll position so make sure that this is set // Other calls to OnScrollerEvent can be filtered out completely so that a document // can load in completely but not had one single call to ScrollTo code allowed. Everything // looks ok but if you scroll slightly then becuase the OldOffset is wrong, usually 0,0, // a large redraw problem can occur OR the whole drawing will be redrawn needlessly. // This is called by the document loading code and so when it says it wants this scroll position // it is generally late enough in the loading process that the 'Fixes bug #1448.' comment // should have been sorted. fSetupDone = TRUE; }

void ScreenView::SetThisFromViewState (   )

Move and resize the ScreenView according to the (device-independent) settings of a ViewState object. This typically happens when a new view is opened on a saved document. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Private See also: ScreenView::SetViewStateFromThis(); ScreenView::OnInitialUpdate() Reimplemented from CCamView. Definition at line 837 of file scrvw.cpp. { PORTNOTETRACE("other","ScreenView::SetThisFromViewState - do nothing"); #ifndef EXCLUDE_FROM_XARALX // Get a pointer to this view's frame window. wxMDIChildFrame *pframewnd = (wxMDIChildFrame *)GetParentFrame(); //ENSURE(pframewnd != NULL, "Found a ScreenView without a frame window?!?"); // Fill in a Windows placement structure with some converted positions from the // ViewState object, and set the placement of the parent frame window accordingly. WINDOWPLACEMENT wp; wp.length = sizeof(wp); wp.flags = WPF_SETMINPOSITION; wp.ptMaxPosition.x = wp.ptMaxPosition.y = 0; // Work out how to display the window, either as an icon, maximised, or just normal. // Note that it is possible for a maximised window to be iconised without being // restore first. if (Status->IsMinimised) { wp.showCmd = SW_SHOWMINIMIZED; // display as an icon if (Status->IsMaximised) { wp.flags |= WPF_RESTORETOMAXIMIZED; // go from icon to maximised } } else if (Status->IsMaximised) { wp.showCmd = SW_SHOWMAXIMIZED; // display maximised } else { wp.showCmd = SW_SHOWNORMAL; // display normally } Coord2POINT(Status->IconPoint, &wp.ptMinPosition); Rect2RECT(Status->ViewRect, &wp.rcNormalPosition); //RALPH if(pframewnd) pframewnd->SetWindowPlacement(&wp); // Set the scroll offset. OldOffset = Status->GetScrollPos(); SetScrollOffset(OldOffset); // Set the scale factor. pDocView->SetViewScale(Status->ViewScale); // If the view was "always on top" then fake a user selection of the appropriate // menu option. // RALPH if (Status->AlwaysOnTop && GetParentFrame()) { GetParentFrame()->PostMessage(WM_SYSCOMMAND, _R(IDM_ALWAYSONTOP)); } #endif }

static void ScreenView::SetUseVisibleDefaults (  BOOL  state  )  [inline, static]

Reimplemented from CCamView. Definition at line 309 of file scrvw.h. { UseVisibleDefaults = state;};

void ScreenView::SetViewStateFromThis (   )  const

Called by a virgin ScreenView, ie. a view onto a new, unedited document. The function reads the attributes of the view window from the operating system, converts them into a device- independent form, and stores them in the ViewState. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Scope: Private See also: ScreenView::OnInitialUpdate; ScreenView::SetThisFromViewState(); DocView::ViewStateChanged(); class ViewState Reimplemented from CCamView. Definition at line 789 of file scrvw.cpp. { // Set the current docview. pDocView->SetCurrent(); // Set most of the ViewState according to the current state (the default) of this // ScreenView. UpdateViewPosition(); // Make sure the scale factor is accurate. FIXED16 scale = pDocView->GetViewScale(); if (scale != Status->ViewScale) Status->ViewScale = scale; // Record the current scroller position. WorkCoord temp; GetScrollOffset(&temp); Status->SetScrollPos(temp); if( NULL != GetParentFrame() ) { // Record the top-most attribute of the frame window. PORTNOTE("other","Removed WM_TOPMOSTENQUIRY usage - is this really needed?") #ifndef EXCLUDE_FROM_XARALX Status->AlwaysOnTop = m_pFrame->SendMessage( WM_TOPMOSTENQUIRY ); #endif } }

void ScreenView::SetWorkAreaExtent (  const WorkRect &  area, BOOL  redraw = TRUE )

Provides read-only access to the WorkAreaExtent, as maintained by DocView/ScreenView. Calculates the size of the RendWnd, setting the "page size" of the scroll bars accordingly. Sets the scroll range of the scroll bars to the size of the WorkAreaExtent (note that the Y range is negated and inverted - the mother of all bodges). Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  WorkRect describing the new WorkAreaExtent, a boolean which if TRUE [INPUTS] means immediately repaint the view window to reflect the change. -  [OUTPUTS] Returns: - Errors: - Scope: Public See also: ScreenView::GetWorkAreaExtent(); CScroller::SetPageSize(); CScroller::SetScrollRange(); class CRendWnd Reimplemented from CCamView. Definition at line 2019 of file scrvw.cpp. { WorkArea = area; FIXED16 PixelWidth, PixelHeight; pDocView->GetPixelSize(&PixelWidth,&PixelHeight); // This doesn't give us a redraw flag. GetCanvas()->SetVirtualSize( INT32((area.hi.x-area.lo.x)/PixelWidth .MakeDouble()), INT32((area.hi.y-area.lo.y)/PixelHeight.MakeDouble()) ); }

BOOL ScreenView::ShouldEatClick (   )  const

void ScreenView::ShowRulers (  BOOL  Show  )

Hide or Show Rulers. Author: Chris_Parks (Xara Group Ltd) <camelotdev@xara.com> Date: 2/11/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: - Reimplemented from CCamView. Definition at line 1320 of file scrvw.cpp. { // WEBSTER - markn 15/1/97 // No rulers in Webster #ifndef WEBSTER #if !defined(EXCLUDE_FROM_RALPH) && !defined(EXCLUDE_FROM_XARALX) if(!VRuler||!HRuler) return; // Set flags and Show/Hide the Scrollers if(VRuler) VRuler->ShowRuler(Show); if(HRuler) HRuler->ShowRuler(Show); Status->RulersVisible = Show; // call OnSize directly to force new layout CRect WRect; GetClientRect(&WRect); SendMessage(WM_SIZE, SIZE_RESTORED, MAKELPARAM(WRect.Width(), WRect.Height())); #endif #endif // WEBSTER }

void ScreenView::ShowScrollers (  BOOL  Show  )

Hide or Show Scrollers. Author: Chris_Parks (Xara Group Ltd) <camelotdev@xara.com> Date: 2/11/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: - Reimplemented from CCamView. Definition at line 1279 of file scrvw.cpp. { PORTNOTETRACE("other","ScreenView::ShowScrollers - do nothing"); #ifndef EXCLUDE_FROM_XARALX // Set flags and Show/Hide the Scrollers if (Show) { VScrollBar->ShowWindow(SW_SHOW); HScrollBar->ShowWindow(SW_SHOW); } else { Status->ScrollersVisible = FALSE; VScrollBar->ShowWindow(SW_HIDE); HScrollBar->ShowWindow(SW_HIDE); } Status->ScrollersVisible = Show; // call OnSize directly to force new layout wxRect WRect; GetClientRect(&WRect); SendMessage(WM_SIZE, SIZE_RESTORED, MAKELPARAM(WRect.Width(), WRect.Height())); */ #endif }

BOOL ScreenView::StartDrag (  Operation *  pOp, DragType  type, BOOL  KeepAccuracy )

Begins a drag operation, from the point of view of the OIL layer. Unbounds the mouse cursor, so it can go off-screen (display driver permitting). Captures all mouse input, to guarantee that the drag being started will terminate properly at some time in the future. Sets some internal variables indicating that ScreenView is in "drag mode". Finally, asks the system for a timer which is used to generate "idle" mouse events. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: ages ago Parameters: A  pointer to the current (drag) Operation; the type of the drag. [INPUTS] -  [OUTPUTS] Returns: Returns TRUE if successful. Returns FALSE if a timer couldn't be allocated. Errors: ASSERTion failure if the ScreenView is already dragging. Scope: Public See also: ScreenView::EndDrag(); ScreenView::HandleDragEvent(); Reimplemented from CCamView. Definition at line 2887 of file scrvw.cpp. { ENSURE( pCurrentDragOp == 0, "ScreenView::StartDrag: pCurrentDragOp is not zero"); // This has been commented out as some screen drivers can not handle the mouse drifting // off the top of the screen. // Unbound mouse from the screen and set the current drag operation. Note that under // Win32 raw mouse coordinates change from being 16-bit INTs to 16-bit SHORTs. //WinRect unbound(SHRT_MIN / 4, SHRT_MIN / 4, SHRT_MAX / 4, SHRT_MAX / 4); //::GetClipCursor(&MouseClipRect); //::ClipCursor(&unbound); GetCanvas()->CaptureMouse(); // Remember what kind of drag we are performing. pCurrentDragOp = pOp; CurrentDragType = type; OLERecaptureMouse = FALSE; DragKeepAccuracy = KeepAccuracy; AutoScrollExcludeRulers = FALSE; m_OLELastOutTime.Sample(); return TRUE; }

void ScreenView::UpdateViewPosition (   )  const [protected]

Updates the ViewState object shared between this ScreenView and its associated DocView with the new size of the view etc. Author: Justin_Flude (Xara Group Ltd) <camelotdev@xara.com> Date: 12/4/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: - Reimplemented from CCamView. Definition at line 912 of file scrvw.cpp. { PORTNOTETRACE("other","ScreenView::UpdateViewPosition - do nothing"); #ifndef EXCLUDE_FROM_XARALX ENSURE(Status != NULL, "No ViewState object in ScreenView::UpdateViewPosition!"); // Get the size of the screen. We don't use this for anything, but I'm afraid to // take it out in case something breaks! // LH 31/08/2005 - Removed, if something breaks I'll revisit! wxRect rc; // GetDesktopWindow()->GetWindowRect( &rc ); // RECT2Rect(rc, &Status->ScreenRect); wxFrame *pframewnd = GetParentFrame(); if(pframewnd) { // Get the rectangle of the parent's MDICLIENT window. All child window sizes and // positions are calculated as relative to this. This is more accurate than just // taking the size of the main frame window as a whole, including menus, title bar etc. GetMainFrame()->GetClientSize( &rc.width, &rc.height ); RECT2Rect(rc, &Status->ParentRect); } // Get the placement information for this view (MDI child) window. Note // that because it is a child window, the position is taken relative to the // client area of its parent. WINDOWPLACEMENT wp; wp.length = sizeof(wp); //ENSURE(pframewnd != NULL, "Found a ScreenView without a frame window?!?"); if(pframewnd) pframewnd->GetWindowPlacement(&wp); // Fill in the ViewState with the position of the normal and iconised // window. The maximised position of the window does not need to be // stored as it always fills the whole MDI client area of its parent. RECT2Rect(wp.rcNormalPosition, &Status->ViewRect); POINT2Coord(wp.ptMinPosition, &Status->IconPoint); // Update the mini/maxi flags. Note that it is possible for IsMinised and IsMaximised // to both be TRUE, if a maximised window has been iconised (but NOT if an iconised // window has been maximised!). if (wp.showCmd == SW_SHOWMINIMIZED) { Status->IsMinimised = TRUE; } else if (wp.showCmd == SW_SHOWMAXIMIZED) { Status->IsMinimised = FALSE; Status->IsMaximised = TRUE; } else // must be SW_SHOWNORMAL, ie. "restored" { Status->IsMinimised = Status->IsMaximised = FALSE; } #endif }

---

Member Data Documentation

BOOL ScreenView::AutoScrollExcludeRulers [protected]

Reimplemented from CCamView. Definition at line 340 of file scrvw.h.

CScrollerCorner* ScreenView::Corner [protected]

Reimplemented from CCamView. Definition at line 284 of file scrvw.h.

DragType ScreenView::CurrentDragType [protected]

Reimplemented from CCamView. Definition at line 353 of file scrvw.h.

wxPoint ScreenView::CurrentMousePos [protected]

Reimplemented from CCamView. Definition at line 346 of file scrvw.h.

WinRect ScreenView::CurrentSize [protected]

Reimplemented from CCamView. Definition at line 294 of file scrvw.h.

BOOL ScreenView::DefaultRulersState = FALSE [static, protected]

Reimplemented from CCamView. Definition at line 302 of file scrvw.h.

BOOL ScreenView::DefaultScrollersState = TRUE [static, protected]

Reimplemented from CCamView. Definition at line 301 of file scrvw.h.

INT32 ScreenView::DragDelay = 500 [static, protected]

Reimplemented from CCamView. Definition at line 334 of file scrvw.h.

BOOL ScreenView::DragKeepAccuracy [protected]

Reimplemented from CCamView. Definition at line 338 of file scrvw.h.

INT32 ScreenView::DragLatency = 3 [static, protected]

This function is called whenever the joystick moves. It is used currently to set the Pretend Pen Pressure from the joystick position. This function only exists under Win32. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 22/6/94 Parameters: The  Joystick position and button states [INPUTS] -  [OUTPUTS] Returns: Returns 0, indicating to Windows that the message has been processed successfully. Errors: - Scope: Protected See also: ScreenView::OnKeyDown() Reimplemented from CCamView. Definition at line 327 of file scrvw.h.

BOOL ScreenView::DragOpInvoke [protected]

Reimplemented from CCamView. Definition at line 397 of file scrvw.h.

String_256 ScreenView::DragOpToken [protected]

Reimplemented from CCamView. Definition at line 395 of file scrvw.h.

MonotonicTime ScreenView::DragTimer [static, protected]

Reimplemented from CCamView. Definition at line 336 of file scrvw.h.

bool ScreenView::fInitialUpdate [protected]

Reimplemented from CCamView. Definition at line 239 of file scrvw.h.

UINT32 ScreenView::FirstClickButton [protected]

Reimplemented from CCamView. Definition at line 350 of file scrvw.h.

BOOL ScreenView::fJustCreated [protected]

Reimplemented from CCamView. Definition at line 240 of file scrvw.h.

BOOL ScreenView::fSetupDone [protected]

Reimplemented from CCamView. Definition at line 238 of file scrvw.h.

OILHorizontalRuler* ScreenView::HRuler [protected]

Reimplemented from CCamView. Definition at line 289 of file scrvw.h.

CWinScroller* ScreenView::HScrollBar [protected]

Reimplemented from CCamView. Definition at line 279 of file scrvw.h.

UINT32 ScreenView::LastClickButton [protected]

Reimplemented from CCamView. Definition at line 344 of file scrvw.h.

ClickModifiers ScreenView::LastClickMods [protected]

Reimplemented from CCamView. Definition at line 347 of file scrvw.h.

wxPoint ScreenView::LastClickPoint [protected]

Reimplemented from CCamView. Definition at line 345 of file scrvw.h.

ClickType ScreenView::LastClickType [protected]

Reimplemented from CCamView. Definition at line 343 of file scrvw.h.

wxPoint ScreenView::LastDoubleClickPos [protected]

Reimplemented from CCamView. Definition at line 454 of file scrvw.h.

MonotonicTime ScreenView::m_OLELastOutTime [protected]

Reimplemented from CCamView. Definition at line 366 of file scrvw.h.

WinRect ScreenView::MouseClipRect [protected]

Reimplemented from CCamView. Definition at line 354 of file scrvw.h.

OriginGadget* ScreenView::OGadget [protected]

Reimplemented from CCamView. Definition at line 291 of file scrvw.h.

WorkCoord ScreenView::OldOffset [protected]

Reimplemented from CCamView. Definition at line 296 of file scrvw.h.

BOOL ScreenView::OLERecaptureMouse [protected]

Reimplemented from CCamView. Definition at line 356 of file scrvw.h.

Operation* ScreenView::pCurrentDragOp [protected]

Reimplemented from CCamView. Definition at line 352 of file scrvw.h.

OpParam* ScreenView::pDragOpParam [protected]

Reimplemented from CCamView. Definition at line 396 of file scrvw.h.

INT32 ScreenView::PopCount [static, protected]

Reimplemented from CCamView. Definition at line 207 of file scrvw.h.

ViewState* ScreenView::pReadyMadeViewState [static, protected]

Reimplemented from CCamView. Definition at line 208 of file scrvw.h.

BOOL ScreenView::PropScrollersOn = TRUE [static, protected]

Definition at line 299 of file scrvw.h.

BOOL ScreenView::ScrollerStyle [protected]

Definition at line 298 of file scrvw.h.

BOOL ScreenView::ThisDoubleIsQuad [protected]

Reimplemented from CCamView. Definition at line 456 of file scrvw.h.

BOOL ScreenView::ThisSingleIsTriple [protected]

Reimplemented from CCamView. Definition at line 455 of file scrvw.h.

MonotonicTime ScreenView::TimeOfLastClick [protected]

Reimplemented from CCamView. Definition at line 453 of file scrvw.h.

BOOL ScreenView::UnzoomOnNewView = FALSE [static, protected]

Definition at line 235 of file scrvw.h.

BOOL ScreenView::UseVisibleDefaults = TRUE [static, protected]

Reimplemented from CCamView. Definition at line 303 of file scrvw.h.

OILVerticalRuler* ScreenView::VRuler [protected]

Reimplemented from CCamView. Definition at line 290 of file scrvw.h.

CWinScroller* ScreenView::VScrollBar [protected]

Reimplemented from CCamView. Definition at line 280 of file scrvw.h.

WorkRect ScreenView::WorkArea [protected]

Reimplemented from CCamView. Definition at line 295 of file scrvw.h.

BOOL ScreenView::ZoomSingleView = TRUE [static, protected]

Definition at line 236 of file scrvw.h.

---

The documentation for this class was generated from the following files:

• wxOil/scrvw.h (r1785/r1282)
• wxOil/scrvw.cpp (r1785/r1354)

---