CP_View_Imp Class Reference
[UI]

MacOS implementation of the CP_View class. More...

Inheritance diagram for CP_View_Imp:

List of all members.

Setters
void	SetCommandID (UInt32 inCommandID)
virtual void	SetLocation (const CP_Point &inLocation)
virtual void	SetSize (const CP_Size &inSize)
virtual void	SetPortBounds (const CP_Rect &inBounds)
Superview
virtual void	AddSubview (CP_View *inView)
void	AdjustToSuperview (CP_View *inView)
Testers
virtual bool	IsVisible () const
virtual bool	IsActive () const
virtual bool	IsEnabled () const
bool	ContainsPoint (const CP_Point &inPortPoint)
Frame
virtual void	HandleBoundsChanged (const CP_Rect &, const CP_Rect &)
virtual void	OnBoundsChanged (const CP_Rect &inPreviousBounds, const CP_Rect &inNewBounds)
Initialization
virtual void	OnInitPersist (CP_View *inSuperview, CP_DataValueList &inDataValueList)
virtual void	OnFinishPersist ()
Drag Target
virtual void	OnDragEnter (CP_DragDrop &inDragDrop, bool inDragHasLeftSender)
virtual void	OnDragLeave (CP_DragDrop &inDragDrop)
virtual void	OnDragTrack (CP_DragDrop &inDragDrop)
static CP_M_DragTarget *	FindDragTarget (OSWindow inOSWindow, CP_Point &inMouseLocation, CP_DragDrop &inDragDrop)
Public Member Functions
CP_ViewBackground *	GetViewBackground ()
void	SetViewBackground (CP_ViewBackground *inViewBackground)
virtual CP_RGBColor	GetBackColor ()
virtual void	HandleMouseDown (CP_Event_Base &inEvent)
virtual void	HandleMouseUp (CP_Event_Base &inEvent)
void	SetID (FourCharCode inIdentifier)
FourCharCode	GetID ()
void	RegisterSignal (const CP_SignalHolder &inSignal)
CP_DataValueSignal *	FindSignal (const CP_String &inSignalName)
UInt32	GetNumberSignals ()
CP_String	GetNthSignalName (UInt32 inSignalIndex)
void	RegisterSlot (const CP_SlotHolder &inSlot)
CP_DataValueSlot	FindSlot (const CP_String &inSlotName)
UInt32	GetNumberSlots ()
CP_String	GetNthSlotName (UInt32 inSlotIndex)
template<class R, class P1, class P2>
CP_CommandHandlerSignal *	Connect (CPLAT::CP_CommandNo cmd, void(R::*handler)(P1, P2), SInt32 mode)
template<class R, class P1, class P2>
void	Connect (CP_Object *control, const CPLAT::CP_String &signalName, void(R::*handler)(P1, P2))
void	disconnect_all ()
void	signal_connect (CP_Signal *inSender)
void	signal_disconnect (CP_Signal *inSender)
void	ClearFlavors ()
virtual void	OnDragEnter (LPDATAOBJECT pIDataSource, DWORD grfKeyState, POINTL pt, LPDWORD pdwEffect)
virtual void	OnDragLeave ()
void	SetTargetWindow (OSWindow inWindow)
virtual void	OnDragOver (DWORD grfKeyState, POINTL pt, LPDWORD pdwEffect)
virtual void	OnDrop (LPDATAOBJECT pIDataSource, DWORD grfKeyState, POINTL pt, LPDWORD pdwEffect)
CP_Point	GetDropPoint ()
Constructor / Destructor
virtual	~CP_View_Imp () throw ()
	Destructor.
Appearance
virtual void	Show ()
virtual void	Hide ()
virtual void	Activate ()
virtual void	Deactivate ()
virtual void	Enable ()
virtual void	Disable ()
Static Public Member Functions
static void	Connect (CP_Object *sender, const CP_String &signalName, CP_Object *receiver, const CP_String &slotName, const bool reciprocal=false)
static void	Connect (CP_Object *sender, CP_Object *receiver, const bool reciprocal=false, const CP_String &signalName=kCP_Signal_ValueChanged, const CP_String &slotName=kCP_Slot_SetValue)
Protected Member Functions
virtual void	HandleControlColor (CP_Event_Base &inEvent)
virtual bool	OnCanAcceptDrag (UInt32 inItem, CP_DragDrop &inDragDrop)=0
virtual bool	PtInDropArea (CP_Point &inGlobalPoint)
virtual bool	OnCanAcceptDragWin (LPDATAOBJECT pIDataSource, DWORD grfKeyState, POINTL pt, LPDWORD pdwEffect)
Constructor / Destructor
	CP_View_Imp ()
	Constructor.
	CP_View_Imp (CP_View *inSuperview, const CP_Point &inUpperLeft, const CP_Size &inContentSize, bool inCreateImp=false, UInt32 inFlags=CP_E_ViewFlags_None)
Protected Attributes
CP_View_Imp_Base *	fViewImpBase
CP_EventHandler	fDummyEventHandler
UInt32	fCommandID
CP_SmartPtr< CP_FrameAdapter >	fFrameAdapter
UInt32	fFlags
CP_ViewBackground *	fViewBackground
CP_DataValueSignal	fBoundsChangedSignal
CP_DataValueSignal	fShowSignal
CP_DataValueSignal	fHideSignal
CP_DataValueSignal	fActivateSignal
CP_DataValueSignal	fDeactivateSignal
CP_DataValueSignal	fEnableSignal
CP_DataValueSignal	fDisableSignal
CP_DataValueSlot	fShowSlot
CP_DataValueSlot	fHideSlot
CP_DataValueSlot	fActivateSlot
CP_DataValueSlot	fDeactivateSlot
CP_DataValueSlot	fEnableSlot
CP_DataValueSlot	fDisableSlot
CP_Signals_Array *	fSignals
CP_Slots_Array *	fSlots
FourCharCode	fObjectID
CP_Commands_Array *	fCommands
CP_MenuSelectionSignal *	fMennuSelectionSignal
sender_set	fSenders
CP_IDropSource *	fIDropSource
CP_IDataObject *	fIDataObject
FORMATETC *	fDataFormats
DWORD	fNumberFormats
CP_Enumerator *	fEnumerator
CP_DataStream	fData
CP_Window *	fWindow
bool	fDropAreaIsHilited
bool	fCanAcceptCurrentDrag
OSWindow	fTargetWindow
CDropTarget *	fDropTarget
CP_Point	fDropPoint
Static Protected Attributes
static FourCharCode	fObjectIDCount = 0
static CP_DragTarget_List *	fsDragTargetList = NULL
static CP_M_DragTarget *	fsCurrentDragTarget = NULL
static bool	fsDragHasLeftSender = false

---

Detailed Description

Under MacOS non HIView all panes are implmented in this class as MacOS user pane controls.

Under Windows all panes are implmented in this class as Windows child windows.

---

Constructor & Destructor Documentation

CP_View_Imp::~CP_View_Imp (   )  throw () [virtual]

Destructor. Exceptions: none

CPLAT_Begin_Namespace_CPLAT CP_View_Imp::CP_View_Imp (   )  [protected]

Constructor. Exceptions: none

CP_View_Imp::CP_View_Imp (  CP_View *  inSuperview, const CP_Point &  inUpperLeft, const CP_Size &  inContentSize, bool  inCreateImp = false, UInt32  inFlags = CP_E_ViewFlags_None )  [protected]

Constructor. Create a pane with the upper left corner at inLocation, and the content size of inSize. Parameters: inSuperview  The subview handler that contains this pane. inLocation  Upper left corner of pane in releation to its superview. inSize  Content size of the pane. inCreateImp  Flag to indicate if the user pane control should be created for this pane. This flag would be true if this is a custom pane and not one of the system controls. Exceptions: none

---

Member Function Documentation

void CP_View_Imp::Show (   )  [virtual]

Show this view. Exceptions: none  Returns: void Reimplemented in CP_Window_Imp, CP_Window_Imp, CP_DrawerWindow, CP_QT_MovieView, CP_SheetWindow, CP_TabView, CP_View, CP_Window, and CP_Window_Imp.

void CP_View_Imp::Hide (   )  [virtual]

Hide this view. Exceptions: none  Returns: void Reimplemented in CP_Window_Imp, CP_Window_Imp, CP_DrawerWindow, CP_QT_MovieView, CP_SheetWindow, CP_TabView, CP_View, CP_Window, and CP_Window_Imp.

void CP_View_Imp::Activate (   )  [virtual]

Activate this view. Exceptions: none  Returns: void Reimplemented in CP_QT_MovieView, CP_TextView, and CP_View.

void CP_View_Imp::Deactivate (   )  [virtual]

Deactivate this view. Exceptions: none  Returns: void Reimplemented in CP_QT_MovieView, CP_TextView, and CP_View.

void CP_View_Imp::Enable (   )  [virtual]

Enable this view. Exceptions: none  Returns: void Reimplemented in CP_QT_MovieView, and CP_View.

void CP_View_Imp::Disable (   )  [virtual]

Disable this view. Exceptions: none  Returns: void Reimplemented in CP_QT_MovieView, and CP_View.

void CP_View_Imp::GlobalToPort (  CP_Point &  inGlobalPoint  )  [virtual]

Converts the passed in point from global to port coordinates. Parameters: inGlobalPoint  The point to convert to port coordinates. Exceptions: none  Returns: void Reimplemented in CP_Window_Imp.

void CP_View_Imp::GlobalToLocal (  CP_Point &  inGlobalPoint  )  [virtual]

Converts the passed in point from global to local coordinates. Parameters: inGlobalPoint  The point to convert to local coordinates. Exceptions: none  Returns: void

void CP_View_Imp::PortToLocal (  CP_Point &  inPortPoint  )

Converts the passed in point from port to local coordinates. Parameters: inGlobalPoint  The point to convert to port coordinates. Exceptions: none  Returns: void

void CP_View_Imp::PortToGlobal (  CP_Point &  inPortPoint  )  [virtual]

Reimplemented in CP_Window_Imp.

void CP_View_Imp::PortToGlobal (  CP_Rect &  inPortRect  )  [virtual]

Reimplemented in CP_Window_Imp.

void CP_View_Imp::LocalToPort (  CP_Point &  inPortPoint  )

void CP_View_Imp::LocalToPort (  CP_Rect &  inPortRect  )

void CP_View_Imp::GetData (  UInt32  inTagName, SInt32  inDataSize, void *  inData )

Sets some user data for this view. This is used to allow users to attach some data to a CP_View object. Parameters: inTagName  Tag name for the data. inDataSize  Size of the data. inData  The data to be set. Exceptions: OSErrExceptions  Returns: void Reimplemented in CP_Window_Imp.

void CP_View_Imp::SetData (  UInt32  inTagName, SInt32  inDataSize, const void *  inData )

Sets some user data for this view. This is used to allow users to attach some data to a CP_View object. Parameters: inTagName  Tag name for the data. inDataSize  Size of the data. inData  The data to be set. Exceptions: OSErrExceptions  Returns: void Reimplemented in CP_Window_Imp.

virtual void CP_View_Imp::HandleDragReceive (  CP_DragDrop &   )  [virtual]

Reimplemented from CP_M_DragTarget.

CP_EventHandler & CP_View_Imp::GetEventHandler (   )  [virtual]

Return the event handler for this view implementation. This will be the OS implentation event handler. Exceptions: none  Returns: CP_EventHandler The OS implementations event handler. Reimplemented in CP_Window_Imp, CP_MDIFrameWindow, and CP_Window_Imp.

CP_Window * CP_View_Imp::GetContainingWindow (   )  [virtual]

Return the CP_Window that contains this pane. Exceptions: none  Returns: CP_Window * Returns the window this pane is contained in. Reimplemented in CP_Window.

CP_View * CP_View_Imp::GetSuperview (   )

Return the superview of this view. Exceptions: none  Returns: CP_View * Return the superview of this view.

CP_Rect CP_View_Imp::GetLocalBounds (   )

Return the local bounds of this pane. This will always have the top left corner at location 0, 0. Exceptions: none  Returns: CP_Rect const Returns the bounds of this pane. Reimplemented in CP_Window_Imp, and CP_Window_Imp.

CP_Rect CP_View_Imp::GetPortBounds (   )  [virtual]

Return the local bounds of this pane. This is the bounds of the pane in port coordinates. Exceptions: none  Returns: CP_Rect const Returns the bounds of this pane. Reimplemented in CP_Window_Imp, and CP_Window_Imp.

CP_Rect CP_View_Imp::GetContentBounds (   )  [virtual]

Reimplemented in CP_Window_Imp, and CP_Scroller.

CP_Point CP_View_Imp::GetLocation (   )  const [virtual]

Return the location of this pane. This is the panes location relative its superviews top left corner. Exceptions: none  Returns: CP_Point const Returns the location of this pane. Reimplemented in CP_Window_Imp.

CP_Size CP_View_Imp::GetSize (   )  const [virtual]

Return the size of this pane. Exceptions: none  Returns: CP_Size const Returns the size of this pane. Reimplemented in CP_Window_Imp, and CP_Window_Imp.

UInt32 CP_View_Imp::GetCommandID (   )

CP_Canvas CP_View_Imp::SetupForDrawing (   )  [virtual]

Used when the user needs to draw into a view at times other than the normal drawing times. This will setup the view for drawing into, and return a canvas object suitable for use. Exceptions: none  Returns: CP_Canvas CP_Canvas object to use to draw into. Reimplemented in CP_QT_MovieView.

void CP_View_Imp::FinishDrawing (  CP_Canvas &  drawCanvas  )

Call after the drawing is complete to free up system resources. Exceptions: none  Returns: CP_Canvas CP_Canvas object to use to draw into.

void CP_View_Imp::HandleDraw (  CP_Canvas &  inCanvas, CP_Region &  inUpdateArea )

CP_View_Imp method called from the user panes callback. This calls the virtual OnDraw function which users override to do the actual drawing in their panes. Parameters: inCanvas  CP_Canvas object to draw into. inUpdateArea  CP_Region containing the area to draw. Exceptions: none  Returns: void

void CP_View_Imp::Invalidate (  const CP_Region &  inInvalidArea  )

Cause the passed in area of this pane to become invalid and force the OS to create an update event to redraw that portion. Parameters: inRegion  CP_Region that contains the invalid area. Region should be in local coordinates. Exceptions: none  Returns: void

void CP_View_Imp::Invalidate (  const CP_Rect &  inInvalidArea  )

Cause the passed in area of this pane to become invalid and force the OS to create an update event to redraw that portion. Parameters: inRect  CP_Rect that contains the invalid area. Rect should be in local coordinates. Exceptions: none  Returns: void

void CP_View_Imp::Refresh (   )  [virtual]

Cause the view to redraw itself on the next chance it gets. This will mark the view as dirty, and redraw itself the next time the underlying OS updates dirty views. If used in a loop, the view will not be redrawn untill the underlying OS can process an event. Exceptions: none  Returns: void Reimplemented in CP_Window_Imp.

UInt32 CP_View_Imp::GetFlags (   )

void CP_View_Imp::SetFlags (  UInt32  inFlags  )

void CP_View_Imp::SetFrameAdapter (  CP_FrameAdapter *  inAdapter  )

Sets the frame adapter for this view. The frame adapter determines how a view will resize and reposition itself when the superview that contains it changes bounds. Parameters: inAdapter  The frame adapter for this view. Exceptions: none  Returns: void

virtual void CP_View_Imp::HandleMouseMoved (  CP_Event_Base &  , const CP_Point &  )  [virtual]

virtual void CP_View_Imp::HandleMouseEntered (  CP_Event_Base &   )  [virtual]

virtual void CP_View_Imp::HandleMouseExited (  CP_Event_Base &   )  [virtual]

void CP_View_Imp::SetCommandID (  UInt32  inCommandID  )

Sets the command id associated with this view. This will be the command sent out when the control is clicked on. Parameters: inCommandID  The command to be sent when clicked on. Exceptions: none  Returns: void

void CP_View_Imp::SetLocation (  const CP_Point &  inLocation  )  [virtual]

Reimplemented in CP_Window_Imp, CP_View, and CP_Window.

void CP_View_Imp::SetSize (  const CP_Size &  inSize  )  [virtual]

Reimplemented in CP_Window_Imp, CP_View, and CP_Window.

void CP_View_Imp::SetPortBounds (  const CP_Rect &  inBounds  )  [virtual]

Sets the bounds of this view in port coordinates. Parameters: inBounds  Bounds of the view in port coordinates. Exceptions: none  Returns: void Reimplemented in CP_Window_Imp.

void CP_View_Imp::Show_Slot (  CP_DataValueHolder &  inValue, OSStatus &  inOutStatus )

void CP_View_Imp::Hide_Slot (  CP_DataValueHolder &  inValue, OSStatus &  inOutStatus )

void CP_View_Imp::Activate_Slot (  CP_DataValueHolder &  inValue, OSStatus &  inOutStatus )

void CP_View_Imp::Deactivate_Slot (  CP_DataValueHolder &  inValue, OSStatus &  inOutStatus )

void CP_View_Imp::Enable_Slot (  CP_DataValueHolder &  inValue, OSStatus &  inOutStatus )

void CP_View_Imp::Disable_Slot (  CP_DataValueHolder &  inValue, OSStatus &  inOutStatus )

void CP_View_Imp::AddSubview (  CP_View *  inView  )  [virtual]

Reimplemented in CP_View.

void CP_View_Imp::AdjustToSuperview (  CP_View *  inView  )

void CP_View_Imp::SetViewImpBase (  CP_View_Imp_Base *  inViewImpBase  )

CP_View_Imp_Base* CP_View_Imp::GetViewImpBase (   )

bool CP_View_Imp::IsVisible (   )  const [virtual]

Returns true if this view is visible. Exceptions: none  Returns: bool const Returns true if the view is visible. Reimplemented in CP_Window_Imp, and CP_View.

bool CP_View_Imp::IsActive (   )  const [virtual]

Returns true if this view is active. Exceptions: none  Returns: bool const Returns true if the view is active. Reimplemented in CP_View, and CP_Window_Imp.

bool CP_View_Imp::IsEnabled (   )  const [virtual]

Returns true if this view is enabled. Exceptions: none  Returns: bool const Returns true if the view is enabled. Reimplemented in CP_View.

bool CP_View_Imp::ContainsPoint (  const CP_Point &  inPortPoint  )

Tests this view to see if it contains the passed in point, which is in port coordinates. Parameters: inPortPoint  Point to check in port coordinates. Exceptions: none  Returns: bool Returns true if the passed in port point is contained in this view.

CP_ViewBackground * CP_View_Imp::GetViewBackground (   )

void CP_View_Imp::SetViewBackground (  CP_ViewBackground *  inViewBackground  )

void CP_View_Imp::CreateImp (  CP_View *  inSuperview, const CP_Point &  inUpperLeft, const CP_Size &  inContentSize, bool  inCreateImp = false )  [protected, virtual]

Creates the MacOS user pane control that performs all drawing and other interaction between this class and the MacOS ControlManager Parameters: inSuperview  The subview handler that contains this pane. inLocation  Upper left corner of pane in releation to its superview. inSize  Content size of the pane. inCreateImp  Flag to indicate if the user pane control should be created for this pane. This flag would be true if this is a custom pane and not one of the system controls. Exceptions: OSStatusException  CP_paramErr if superview is NULL Returns: void

void CP_View_Imp::OnDraw (  CP_Canvas &  inCanvas, CP_Region &  inUpdateArea )  [protected, virtual]

Virtual method that users use to handle the actual drawing of their panes data. All platform implemntations eventually call this method to perform the actual drawing, and this is the only place that drawing should occur in. You can also assume that by the time this method is called, the clipping region and other necessary platform stuff has been setup for you to draw. The passed in canvas also contains a valid port for drawing into. Parameters: inCanvas  CP_Canvas object to draw into. inUpdateArea  CP_Region containing the area to draw. Exceptions: none  Returns: void Reimplemented in CP_BackgroundView, CP_BevelButton, CP_BevelButton, CP_ChasingArrows, CP_ChasingArrows, CP_CheckGroupBox, CP_DisclosureButton, CP_DisclosureButton, CP_DisclosureButton, CP_DisclosureTriangle, CP_DisclosureTriangle, CP_FocusBorder, CP_IconControl, CP_IconControl, CP_ImageWell, CP_ImageWell, CP_OpenGLView, CP_PictureControl, CP_PictureControl, CP_Placard, CP_Placard, CP_PopupArrow, CP_PopupArrow, CP_PopupButton, CP_PopupGroupBox, CP_QT_MovieView, CP_Relevance, CP_Relevance, CP_Relevance, CP_RoundButton, CP_RoundButton, CP_RoundButton, CP_Scroller, CP_SearchField, CP_SearchField, CP_SearchField, CP_SegmentView, CP_SegmentView, CP_SegmentView, CP_SelectColorButton, CP_Separator, CP_Splitter, CP_StaticText, CP_TableHeaders, CP_TableView, CP_TextGroupBox, CP_TV_DataBrowser, CP_TV_TextColumn, CP_WindowHeader, CP_WindowHeader, and CP_WindowListHeader.

bool CP_View_Imp::OnCanAcceptDrag (  UInt32  inItem, CPLAT::CP_DragDrop &  inDragDrop )  [protected, virtual]

Linux - Returns true if this view supports drag and drop. This default implementation just returns true if the CP_E_ViewFlags_SupportsDragAndDrop is set, and does not check the contents of the drag and drop. Users should override this to perform a check on the contents of the drag and drop to determine if an item is acceptable. Parameters: inItem  Index of the item to check. inDragDrop  CP_DragDrop object that is handling this drag and drop. Exceptions: none  Returns: bool Returns true if the view flags support drag and drop.

void CP_View_Imp::InitEventHandler (  CP_EventHandler &  inEventHandler  )  [protected, virtual]

Initialize the event handler for events that this class will handle. Parameters: inEventHandler  CP_EventHandler that handles events for this class. Exceptions: none  Returns: void Reimplemented in CP_Window_Imp, CP_BevelButton, CP_ChasingArrows, CP_DisclosureButton, CP_DisclosureTriangle, CP_DocumentWindow, CP_DrawerWindow, CP_EditField, CP_FocusBorder, CP_LittleArrows, CP_LittleArrowsEditBuddy, CP_PlatformControl, CP_PopupButton, CP_PopupMenu, CP_ProgressBar, CP_PushButton, CP_QT_MovieView, CP_RadioGroup, CP_ScrollBar, CP_SearchField, CP_SegmentView, CP_SelectColorButton, CP_Slider, CP_Splitter, CP_TableHeaders, CP_TableView, CP_TabView, CP_TextGroupBox, CP_TextView, CP_Toolbar, CP_WindowListHeader, CP_MDIFrameWindow, CP_MenuBarWindow, and CP_Window_Imp.

virtual void CP_View_Imp::HandleBoundsChanged (  const CP_Rect &  , const CP_Rect &  )  [protected, virtual]

Reimplemented in CP_Scroller, CP_Splitter, and CP_View.

void CP_View_Imp::OnBoundsChanged (  const CP_Rect &  inPreviousBounds, const CP_Rect &  inNewBounds )  [protected, virtual]

Called when the bounds of this view has changed. Parameters: inPreviousBounds  The previous bounds of this view. inNewBounds  The new bounds to make this view. Exceptions: none  Returns: void Reimplemented in CP_OpenGLView, and CP_QT_MovieView.

ControlPartCode CP_View_Imp::HandleHitTest (  const CP_Point &  inMouseLocation  )  [virtual]

Slot to disable a view. Reimplemented in CP_SelectColorButton, CP_Splitter, and CP_TableView.

ControlPartCode CP_View_Imp::HandleTracking (  const CP_Point &  inMouseLocation, ControlActionUPP  actionProc )  [virtual]

MacOS - Called when the user is holding the mouse down, and moving it in this view. This will track the mouse until the user has released the mouse button. The last part the mouse was over when the user has released the mouse button is returned. Parameters: innMouseLocation  The location of the mouse we are checking. inActionProc  Not used. Exceptions: none  Returns: ControlPartCode MacOS control part code under the mouse when the user released the mouse button. Reimplemented in CP_SelectColorButton, CP_Splitter, CP_TableView, and CP_TV_DataBrowser.

ControlPartCode CP_View_Imp::HandleFocus (  ControlFocusPart  inFocusPart  )  [virtual]

MacOS - Called when some action is causing this view to become focused. This default implementation returnns kControlNoPart. Parameters: inAction  Not used. Exceptions: none  Returns: ControlPartCode MacOS control part code receiving the focus. Reimplemented in CP_TableView.

void CP_View_Imp::HandleActivate (  Boolean  inActivating  )  [virtual]

void CP_View_Imp::HandleKeyDown (  SInt16  keyCode, SInt16  charCode, SInt16  modifiers )  [virtual]

Reimplemented in CP_TableView.

WindowRef CP_View_Imp::GetDragWindow (   )  [protected, virtual]

MacOS - Returns the WindowRef of our containing window when the user has dragged an object over it. Exceptions: none  Returns: WindowRef The MacOS WindowRef for the containing window.

CP_Region CP_View_Imp::GetDropRegion (   )  [protected, virtual]

MacOS - Returns the region of our target view that can accept the object that is currently over this view. The default implementation returns the the entire view bounds. Users can override if they want to only have a portion of the view act as a drop area. Exceptions: none  Returns: CP_Region The area of the view that can accept the dropped item. Implements CP_M_DragTarget.

virtual bool CP_View_Imp::PtInDropArea (  CPLAT::CP_Point &  inGlobalPoint  )  [protected, virtual]

CP_RGBColor CP_View_Imp::GetBackColor (   )  [virtual]

Windows - Returns the background color of this view. The default is to return white. Other views that have a colored background will return the controls color for that view. Exceptions: none  Returns: CP_RGBColor The color of this views background. Reimplemented in CP_TabView, and CP_Window.

void CP_View_Imp::HandleControlColor (  CP_Event_Base &  inEvent  )  [protected, virtual]

Windows - Handles the Windows control color event to setup and return an HBRUSH that corresponds to the correct background color to use. Parameters: inEvent  The control color event where the result is returned in. Exceptions: none  Returns: void Reimplemented in CP_EditField.

void CP_View_Imp::HandleMouseDown (  CP_Event_Base &  inEvent  )  [virtual]

Linux - Called when the user has pressed the mouse down in this view. Subclasses need to override to do any useful processing. Parameters: inEvent  CP_Event describing the mouse down event. Exceptions: none  Returns: void Reimplemented in CP_BevelButton, CP_DisclosureButton, CP_DisclosureButton, CP_DisclosureButton, CP_DisclosureTriangle, CP_DisclosureTriangle, CP_IconControl, CP_IconControl, CP_PictureControl, CP_PictureControl, CP_PopupButton, CP_RoundButton, CP_RoundButton, CP_RoundButton, CP_Splitter, and CP_TextView.

void CP_View_Imp::HandleMouseUp (  CP_Event_Base &  inEvent  )  [virtual]

Linux - Called when the user has released the mouse in this view. Subclasses need to override to do any useful processing. Parameters: inEvent  CP_Event describing the mouse down event. Exceptions: none  Returns: void Reimplemented in CP_BevelButton, CP_DisclosureButton, CP_IconControl, CP_PictureControl, CP_PopupButton, and CP_RoundButton.

void CP_M_Persist::InitPersist (  CP_View *  inSuperview, CP_DataValueList &  inDataValueList )  [inherited]

Finish initializing our object. Calls OnInitPersist to do the actual work. Parameters: inSuperview  The CP_View that contains this object. inDataValueList  List of data values used to construct this object. Exceptions: none  Returns: void

void CP_M_Persist::FinishPersist (   )  [inherited]

Called when we have constructed our persist objects and are now giving each one a chance to finish up. Calls OnFinishPersist to do the actual work. Exceptions: none  Returns: void

void CP_M_Persist::OnInitPersist (  CP_View *  inSuperview, CP_DataValueList &  inDataValueList )  [protected, virtual, inherited]

Finish initializing our object. Called from InitPersist. This is the method to override to initialize your object. Parameters: inSuperview  The CP_View that contains this object. inDataValueList  List of data values used to construct this object. Exceptions: none  Returns: void Reimplemented in CP_BevelButton, CP_ChasingArrows, CP_CheckBox, CP_CheckGroupBox, CP_Clock, CP_DisclosureButton, CP_DisclosureTriangle, CP_EditField, CP_FocusBorder, CP_IconControl, CP_ImageWell, CP_LittleArrows, CP_LittleArrowsEditBuddy, CP_OpenGLView, CP_PictureControl, CP_Placard, CP_PopupArrow, CP_PopupGroupBox, CP_PopupMenu, CP_ProgressBar, CP_PushButton, CP_QT_MovieView, CP_RadioButton, CP_RadioGroup, CP_Relevance, CP_RoundButton, CP_ScrollableView, CP_ScrollBar, CP_Scroller, CP_SearchField, CP_SegmentView, CP_SelectColorButton, CP_Separator, CP_Slider, CP_Splitter, CP_StaticText, CP_TabGroup, CP_TableHeaders, CP_TableView, CP_TabView, CP_TextGroupBox, CP_TextView, CP_TV_DataBrowser, CP_TV_TextColumn, CP_View, CP_ViewBackground, CP_ViewBackground_White, CP_Window, CP_WindowHeader, and CP_WindowListHeader.

virtual void CP_M_Persist::OnFinishPersist (   )  [protected, virtual, inherited]

Override this do the actual finishing up of initializing the persist object. This is called after all of the other objects have been created. Exceptions: none  Returns: void Reimplemented in CP_TabView, and CP_View.

void CP_Object::SetID (  FourCharCode  inIdentifier  )  [inherited]

Sets the identifier for this object. If a specific identifier is not set with this function, then a default id is used, which is simply a running count of the number of objects created. Parameters: inIdentifier  The objects identifier. Returns: void

FourCharCode CP_Object::GetID (   )  [inherited]

Returns the objects identifier. Returns: FourCharCode The identifier of this object.

void CP_Object::RegisterSignal (  const CP_SignalHolder &  inSignal  )  [inherited]

Registers the signal / signal name contained in the passed in inSignal object. Parameters: inSignal  CP_SignalHolder that holds a signal and string identifier. Returns: void

CP_DataValueSignal * CP_Object::FindSignal (  const CP_String &  inSignalName  )  [inherited]

Finds the CP_DataValueSignal object that matches the passed in inSignalName. Parameters: inSignalName  CP_String containing the identifier of the signal to return. Returns: CP_DataValueSignal * Returns a pointer to a CP_DataValueSignal object.

UInt32 CP_Object::GetNumberSignals (   )  [inherited]

Returns the number of signals for this object. Returns: UInt32 The number of signals.

CP_String CP_Object::GetNthSignalName (  UInt32  inSignalIndex  )  [inherited]

Returns the signal name of the passed in signal index. Parameters: inSignalIndex  Index of the name of the signal to return. Returns: CP_String The name of the nth signal being returned.

void CP_Object::RegisterSlot (  const CP_SlotHolder &  inSlot  )  [inherited]

Registers the slot / slot name contained in the passed in inSlot object. Parameters: inSlot  CP_SignalHolder that holds a slot and string identifier. Returns: void

CP_DataValueSlot CP_Object::FindSlot (  const CP_String &  inSlotName  )  [inherited]

Finds the CP_Slot1 object that matches the passed in inSlotName. Parameters: inSlotName  CP_String containing the identifier of the slot to return. Returns: CP_DataValueSlot Returns a pointer to a CP_DataValueSlot object.

UInt32 CP_Object::GetNumberSlots (   )  [inherited]

Returns the number of slots for this object. Returns: UInt32 The number of slots.

CP_String CP_Object::GetNthSlotName (  UInt32  inSlotIndex  )  [inherited]

Returns the slot name of the passed in signal index. Parameters: inSlotIndex  Index of the name of the slot to return. Returns: CP_String The name of the nth slot being returned.

template<class R, class P1, class P2> CP_CommandHandlerSignal* CP_Object::Connect (  CPLAT::CP_CommandNo  cmd, void(R::*)(P1, P2)  handler, SInt32  mode )  [inherited]

template<class R, class P1, class P2> void CP_Object::Connect (  CP_Object *  control, const CPLAT::CP_String &  signalName, void(R::*)(P1, P2)  handler )  [inherited]

void CP_Object::Connect (  CP_Object *  sender, const CP_String &  signalName, CP_Object *  receiver, const CP_String &  slotName, const bool  reciprocal = false )  [static, inherited]

void CP_Object::Connect (  CP_Object *  sender, CP_Object *  receiver, const bool  reciprocal = false, const CP_String &  signalName = kCP_Signal_ValueChanged, const CP_String &  slotName = kCP_Slot_SetValue )  [static, inherited]

bool CP_M_CommandHandler::UpdateCommandStatus (  CP_CommandNo  inOSCommand, CP_CommandStatus &  inOutCommandStatus )  [inherited]

Updates the status of a command. Parameters: inOSCommand  The CP_CommandNo assigned to the command. inOutCommandStatus  CP_CommandStatus object that holds the result of the update for the command. Exceptions: none  Returns: bool True if the command was handled.

bool CP_M_CommandHandler::UpdateCommandStatusForAppState (  CP_CommandNo  inOSCommand, CP_CommandStatus &  inOutCommandStatus, CP_Command *  inCommand )  [virtual, inherited]

Updates the status of a command based on the current state of the application. Parameters: inOSCommand  The CP_CommandNo assigned to the command. inOutCommandStatus  CP_CommandStatus object that holds the result of the update for the command. inCommand  CP_Command object with the command. Exceptions: none  Returns: bool True if the command was handled.

OSStatus CP_M_CommandHandler::HandleCommand (  CP_CommandNo  inOSCommand  )  [inherited]

Handles the processing of a command. If the command has been registered with this class, then its signal will be called. If the command has not been registered, then this function does nothing with the passed in command. Parameters: inOSCommand  The CP_CommandNo assigned to the command. Exceptions: NULL  exceptions. Returns: OSStatus Result of the command handling.

OSStatus CP_M_CommandHandler::HandleCommand (  HICommand  inCommand, CP_Menu *  inMenu = NULL )  [inherited]

Signal called when a menu item is selected with no associated command.

CP_MenuSelectionSignal* CP_M_CommandHandler::GetMenuSelectionSignal (   )  [inherited]

Returns the signal called when a menu item is selected and has no command associated with it. Exceptions: none  Returns: CP_MenuSelectionSignal * Returns the menu selection signal.

void CP_M_CommandHandler::RegisterCommand (  CP_CommandNo  inOSCommand, CP_CommandHandlerSignal *  inCommandHandler, CP_CommandStatusSignal *  inCommandStatus )  [inherited]

Registers the passed in command. This places the command in a list of commands we will handle updating the status for, and when called executing the signal registered for the command. Parameters: inOSCommand  The CP_CommandNo assigned to the command. inCommandHandler  The CP_CommandHandlerSignal called when the command is called to be executed. Note: This signal will be deleted when the command is removed from the list of commands, and should be unique for each command, ie don't assign the same signal to the same command. inCommandStatus  The CP_CommandStatusSignal called when the commands status needs to be updated. Note: This signal will be deleted when the command is removed from the list of commands, and should be unique for each command, ie don't assign the same signal to the same command. Exceptions: none  Returns: void

void CP_M_CommandHandler::RegisterCommand (  CP_CommandNo  inOSCommand, CP_CommandHandlerSignal *  inCommandHandler, SInt32  inFlags )  [inherited]

Registers the passed in command. This places the command in a list of commands we will handle updating the status for, and when called executing the signal registered for the command. Parameters: inOSCommand  The CP_CommandNo assigned to the command. inCommandHandler  The CP_CommandHandlerSignal called when the command is called to be executed. Note: This signal will be deleted when the command is removed from the list of commands, and should be unique for each command, ie don't assign the same signal to the same command. inFlags  Flags used to update the status of the command instead of calling a signal to do the updating. Exceptions: none  Returns: void

CP_CommandHandlerSignal * CP_M_CommandHandler::RegisterCommand (  CP_CommandNo  inOSCommand, SInt32  inFlags )  [inherited]

Registers the passed in command. This places the command in a list of commands we will handle updating the status for. You are returned the signal object that you need to connect your slot to. Parameters: inOSCommand  The CP_CommandNo assigned to the command. inFlags  Flags used to update the status of the command instead of calling a signal to do the updating. Exceptions: none  Returns: CP_CommandHandlerSignal The command handler signal that will be called when the command is executed. You need to connect your slot to this signal.

CP_CommandStatusSignal * CP_M_CommandHandler::RegisterUpdateStatusHandler (  CP_CommandNo  inOSCommand  )  [inherited]

Registers the passed in command, returning the command status signal. If the command already exists, we will return the existing command status signal if there is one, otherwise we create a new signal, and return that signal. If there is already a signal, then return the existing signal. Parameters: inOSCommand  The CP_CommandNo assigned to the command. Exceptions: none  Returns: CP_CommandStatusSignal The command status signal that will be called when the command is executed. You need to connect your slot to this signal.

CP_CommandHandlerSignal * CP_M_CommandHandler::RegisterCommandHandler (  CP_CommandNo  inOSCommand  )  [inherited]

Registers the passed in command, returning the command handling signal. If the command already exists, we will return the existing command handler signal if there is one, otherwise we create a new signal, and return that signal. If there is already a signal, then return the existing signal. Parameters: inOSCommand  The CP_CommandNo assigned to the command. Exceptions: none  Returns: CP_CommandHandlerSignal The command handler signal that will be called when the command is executed. You need to connect your slot to this signal.

bool CP_M_CommandHandler::IsRegisteredCommand (  CP_CommandNo  inOSCommand  )  const [inherited]

Returns true if the passed in command is known to this class. Parameters: inOSCommand  The CP_CommandNo assigned to the command. Exceptions: none  Returns: bool const Returns true if we have previously registered the passed in command.

void CP_M_CommandHandler::ReplaceCommand (  CP_CommandNo  inOSCommand, CP_Command *  inCommand )  [inherited]

Replaces a CP_Command for the passed in command number. Parameters: inOSCommand  The CP_CommandNo assigned to the command. inCommand  The CP_Command to replace with. Exceptions: none  Returns: void

void CP_M_CommandHandler::UnRegisterCommand (  CP_CommandNo  inOSCommand  )  [inherited]

Unregisters a command. Parameters: inOSCommand  The CP_CommandNo to remove from the list of known commands we handle. Exceptions: none  Returns: void

CP_Command * CP_M_CommandHandler::GetCommand (  CP_CommandNo  inOSCommand  )  [inherited]

Returns the CP_Command object associated with the passed in command number. Parameters: inOSCommand  The CP_CommandNo assigned to the command. Exceptions: none  Returns: CP_Command * CP_Command object associated with the passed in command number. Note: This will return a NULL CP_Command if the command has not been registered yet.

OSStatus CP_M_CommandHandler::HandleCommandUpdateStatus (  HICommand  inCommand, CP_Menu *  inMenu = NULL )  [inherited]

MacOS - Handles the processing of the passed in HICommand. This will translate the HICommand into a CPLAT CP_CommandNo for processing and updating the status of the command. Parameters: inCommand  The HICommand to be handled. Exceptions: OSError  exceptions. Returns: OSStatus Result of the command handling.

OSStatus CP_M_CommandHandler::UpdateCommandStatusOS (  CP_CommandStatus  inCommandStatus, bool  inResult, HICommand  inCommand )  [inherited]

void CP_SigSlot::CP_SlotObject::disconnect_all (   )  [inherited]

void CP_SigSlot::CP_SlotObject::signal_connect (  CP_Signal *  inSender  )  [inherited]

void CP_SigSlot::CP_SlotObject::signal_disconnect (  CP_Signal *  inSender  )  [inherited]

void CP_M_DragSource::AddFlavor (  CP_DragDrop &  inDragDrop, FlavorType  inFlavor, const void *  inData, SInt32  inSize, UInt32  inFlags = 0, UInt32  inItem = 0 )  [protected, virtual, inherited]

Tracks the drag by calling on the OS to handle the drag. Parameters: inDragDrop  The CP_DragDrop object performing the drag and drop operation. FlavorType  Type of data being added. inData  Data being added. inSize  Size of the data being added. inFlags  Flags describing the flavor. inItem  Item reference number. Exceptions: none  Returns: void

void CP_M_DragSource::TrackDrag (  CP_DragDrop &  inDragDrop, CP_Event_Base &  inEvent )  [protected, virtual, inherited]

Tracks the drag by calling on the OS to handle the drag. Parameters: inDragDrop  The CP_DragDrop object performing the drag and drop operation. inEvent  Originating mouse event that initiated this drag and drop. Exceptions: none  Returns: void

CP_IDropSource* CP_M_DragSource::GetIDropSource (   )  [inherited]

Return the CP_IDropSource object for the Windows OLE IDropSource interface .

CP_IDataObject* CP_M_DragSource::GetIDataObject (   )  [inherited]

Return the CP_IDataObject object for the Windows OLE IDataObject interface .

HRESULT CP_M_DragSource::GetData (  LPFORMATETC  lpfe, LPSTGMEDIUM  lpstg )  [inherited]

GetData method. Caller is asking if we can supply data in a given format and medium. Subclasses should override the OnGetData method to return the data. Parameters: lpfe  Pointer to a FORMATETC structure. lpstg  Pointer to a STGMEDIUM structure. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::GetDataHere (  LPFORMATETC  lpfe, LPSTGMEDIUM  lpst )  [inherited]

GetDataHere method. Parameters: lpfe  Pointer to a FORMATETC structure. lpstg  Pointer to a STGMEDIUM structure. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::EnumFormatEtc (  DWORD  dwDir, LPENUMFORMATETC *  lpEnum )  [inherited]

Return a FORMATETC enumerator object to enumerate over the types of formats we supply. Parameters: dwDir  Not used. lpEnum  Pointer to a ENUMFORMATEC structure. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::GetCanonicalFormatEtc (  LPFORMATETC  lpout, LPFORMATETC  lpin )  [inherited]

GetCanonicalFormatEtc method. Parameters: lpfe  Pointer to a FORMATETC structure. lpstg  Pointer to a STGMEDIUM structure. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::QueryGetData (  LPFORMATETC  lpfe  )  [inherited]

Caller is asking for data in a specified format. Parameters: lpfe  Pointer to a FORMATETC structure. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::SetData (  LPFORMATETC  lpfe, STGMEDIUM *  lpst, BOOL  fRelease )  [inherited]

SetData method. Calls OnSetData which you should override if needed. Parameters: lpfe  Pointer to a FORMATETC structure. lpstg  Pointer to a STGMEDIUM structure. fRelease  Flag to indicate if the data is to be released. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::DAdvise (  FORMATETC *  lpfe, DWORD  dw, LPADVISESINK  lpas, DWORD FAR *  lpdw )  [inherited]

DAdvise method. Calls OnDAdvise which you should override if needed. Parameters: lpfe  Pointer to a FORMATETC structure. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::DUnadvise (  DWORD  dw  )  [inherited]

DAdvise method. Calls OnDUnadvise which you should override if needed. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::EnumDAdvise (  LPENUMSTATDATA *  lpen  )  [inherited]

DAdvise method. Calls OnEnumDAdvise which you should override if needed. Exceptions: none  Returns: HRESULT

void CP_M_DragSource::ClearFlavors (   )  [inherited]

Empty the list of data flavors currently being stored. Exceptions: none  Returns: void

HRESULT CP_M_DragSource::OnGetData (  LPFORMATETC  lpfe, LPSTGMEDIUM  lpstg )  [protected, virtual, inherited]

GetData Method. Caller is asking if we can supply data in a given format and medium. If your data is in a format other than kCP_E_ClipboardFormat_DataStream you need to override this to provide your data. Parameters: lpfe  Pointer to a FORMATETC structure. lpstg  Pointer to a STGMEDIUM structure. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::OnQueryGetData (  LPFORMATETC  lpfe  )  [protected, virtual, inherited]

GetData Method. Caller is asking if we can supply data in a given format. If your data is in a format other than kCP_E_ClipboardFormat_DataStream you need to override this to provide your data. Parameters: lpfe  Pointer to a FORMATETC structure. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::OnGetDataHere (  LPFORMATETC  lpfe, LPSTGMEDIUM  lpst )  [protected, virtual, inherited]

OnGetDataHere method. Returns E_NOTIMPL. Subclasses need to override if they implement. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::OnGetCanonicalFormatEtc (  LPFORMATETC  lpout, LPFORMATETC  lpin )  [protected, virtual, inherited]

OnGetCanonicalFormatEtc method. Returns E_NOTIMPL. Subclasses need to override if they implement. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::OnSetData (  LPFORMATETC  lpfe, STGMEDIUM *  lpst, BOOL  fRelease )  [protected, virtual, inherited]

OnSetData method. Returns E_NOTIMPL. Subclasses need to override if they implement. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::OnDAdvise (  FORMATETC *  lpfe, DWORD  dw, LPADVISESINK  lpas, DWORD FAR *  lpdw )  [protected, virtual, inherited]

OnDAdvise method. Returns E_NOTIMPL. Subclasses need to override if they implement. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::OnDUnadvise (  DWORD  dw  )  [protected, virtual, inherited]

OnDUnadvise method. Returns E_NOTIMPL. Subclasses need to override if they implement. Exceptions: none  Returns: HRESULT

HRESULT CP_M_DragSource::OnEnumDAdvise (  LPENUMSTATDATA *  lpen  )  [protected, virtual, inherited]

OnEnumDAdvise method. Returns E_NOTIMPL. Subclasses need to override if they implement. Exceptions: none  Returns: HRESULT

void CP_M_DragTarget::AddDragTarget (  CP_M_DragTarget *  inDragTarget, CP_Window *  inWindow )  [inherited]

Adds the passed in CP_M_DragTarget to the global list of drag targets that this object maintains. This is the list of objects that get checked during a drag and drop operation to see if the object can receive the dropped object when the mouse if over the target object. Parameters: inDragTarget  The object that can be the receipient of a drag and drop operation. inWindow  The window that contains the drag target. Exceptions: none

void CP_M_DragTarget::RemoveDragTarget (  CP_M_DragTarget *  inDragTarget, CP_Window *  inWindow )  [inherited]

Removes a previously added CP_M_DragTarget object. This is called for you automatically when aa CP_M_DragTarget object is destroyed. However you can call this at other times, if you want to remove an object as a postential drop target for drag and drops. Parameters: inDragTarget  The object that is going to be removed. inWindow  The window that contains the drag target. Exceptions: none

bool CP_M_DragTarget::CanAcceptDrag (  CP_DragDrop &  inDragDrop  )  [inherited]

Screen location where drop occurred.

void CP_M_DragTarget::HiliteDropArea (  CP_DragDrop &  inDragDrop  )  [virtual, inherited]

Called when the drag enters a new drop area. This is used to show the MacOS default drag hiliting. Parameters: inDragDrop  The CP_DragDrop object that is performing the drag and drop. Exceptions: none  Returns: void

void CP_M_DragTarget::UnhiliteDropArea (  CP_DragDrop &  inDragDrop  )  [virtual, inherited]

Called when the drag leaves a drop area. This is used to remove the MacOS default drag hiliting. Parameters: inDragDrop  The CP_DragDrop object that is performing the drag and drop. Exceptions: none  Returns: void

pascal::OSErr CP_M_DragTarget::HandleDragTrackingCallback (  DragTrackingMessage  inMessage, WindowPtr  inOSWindow, void *  inRefCon, DragReference  inDragRef )  [static, protected, inherited]

Callback to the MacOS Drag Manager that is called during a drag and drop tracking operation. Parameters: inMessage  The message or reason that this callback was called. inOSWindow  The MacOS window that the drag is ocurring in. inRefCon  Not used. inDragRef  The Drag Manager DragReference for this drag and drop. Exceptions: none  Returns: OSErr The result of this operation.

pascal OSErr CP_M_DragTarget::HandleDragReceiveCallback (  WindowPtr  inOSWindow, void *  inRefCon, DragReference  inDragRef )  [static, protected, inherited]

Callback to the MacOS Drag Manager when the user has dropped an object over a drag target. Parameters: inOSWindow  The MacOS window that the drop occured over. inRefCon  Not used. inDragRef  The Drag Manager DragReference for this drag and drop. Exceptions: none  Returns: OSErr The result of this operation.

CP_M_DragTarget * CP_M_DragTarget::FindDragTarget (  OSWindow  inOSWindow, CP_Point &  inMouseLocation, CP_DragDrop &  inDragDrop )  [static, protected, inherited]

Finds and returns the CP_M_DragTarget that is in the passed in OSWindow at the passed in mouse location. The mouse location is in global coordinates. If no target was found at the passed in location, then NULL is returned. Parameters: inOSWindow  The MacOS window that the mouse is over. inMouseLocation  Global location of the mouse. inDragDrop  The CP_DragDrop object that is performing the drag and drop. Exceptions: none  Returns: CP_M_DragTarget * The object that was registered to handle a drag and drop at the passed in mouse location. NULL is returned if no target object was found.

void CP_M_DragTarget::OnDragEnter (  CP_DragDrop &  inDragDrop, bool  inDragHasLeftSender )  [protected, virtual, inherited]

Called when the user has entered a registered drag target object. Parameters: inDragDrop  The CP_DragDrop object that is performing the drag and drop. inDragHasLeftSender  Flag to indicate if the drag operation has left the sending object, and is now in another object. Exceptions: none  Returns: void

void CP_M_DragTarget::OnDragEnter (  LPDATAOBJECT  pIDataSource, DWORD  grfKeyState, POINTL  pt, LPDWORD  pdwEffect )  [virtual, inherited]

Called when we are entering a new drag target.

void CP_M_DragTarget::OnDragLeave (  CP_DragDrop &  inDragDrop  )  [protected, virtual, inherited]

Called when the user is has left the current drag target object. Parameters: inDragDrop  The CP_DragDrop object that is performing the drag and drop. Exceptions: none  Returns: void

void CP_M_DragTarget::OnDragLeave (   )  [virtual, inherited]

Called when we leave the current target.

void CP_M_DragTarget::OnDragTrack (  CP_DragDrop &  inDragDrop  )  [protected, virtual, inherited]

Called when the user is tracking or moving the mouse during a drag and drop operationn. Parameters: inDragDrop  The CP_DragDrop object that is performing the drag and drop. Exceptions: none  Returns: void

virtual bool CP_M_DragTarget::OnCanAcceptDrag (  UInt32  inItem, CP_DragDrop &  inDragDrop )  [protected, pure virtual, inherited]

bool CP_M_DragTarget::PtInDropArea (  CP_Point &  inGlobalPoint  )  [protected, virtual, inherited]

Returns true if the passed in global point is over this drag target. Parameters: inGlobalPoint  The location of the mouse in global coordinates to test against. The default implmentation gets the drop region for the target, and compares the location to the drop region. Exceptions: none  Returns: bool Returns true if the passed in point is over the drop region for this drag target.

void CP_M_DragTarget::HandleTrackInWindow (  WindowPtr  inOSWindow, CP_DragDrop &  inDragDrop )  [static, protected, inherited]

Called when the user is dragging an object around in a window. This is called from the MacOS Drag Manager callback. Parameters: inOSWindow  The MacOS window that the user is dragging an object over. inDragDrop  The CP_DragDrop object that is performing the drag and drop. Exceptions: none  Returns: void

void CP_M_DragTarget::SetTargetWindow (  OSWindow  inWindow  )  [inherited]

Register a Windows HWND as a possible target for dropping objects onto. Parameters: inWindow  - the Windows HWND that is to be the target.

void CP_M_DragTarget::OnDragOver (  DWORD  grfKeyState, POINTL  pt, LPDWORD  pdwEffect )  [virtual, inherited]

Called while we are dragging over the target object.

void CP_M_DragTarget::OnDrop (  LPDATAOBJECT  pIDataSource, DWORD  grfKeyState, POINTL  pt, LPDWORD  pdwEffect )  [virtual, inherited]

Called when the data is dropped onto the target object. Subclasses need to override this method.

CP_Point CP_M_DragTarget::GetDropPoint (   )  [inherited]

bool CP_M_DragTarget::OnCanAcceptDragWin (  LPDATAOBJECT  pIDataSource, DWORD  grfKeyState, POINTL  pt, LPDWORD  pdwEffect )  [protected, virtual, inherited]

Return true if this object can accept the dropped data. Subclasses need to override.

---

Member Data Documentation

CP_View_Imp_Base* CP_View_Imp::fViewImpBase [protected]

CP_EventHandler CP_View_Imp::fDummyEventHandler [protected]

Object that actually implements the pane.

UInt32 CP_View_Imp::fCommandID [protected]

Dummy event handler if the view imp has not been created.

CP_SmartPtr<CP_FrameAdapter> CP_View_Imp::fFrameAdapter [protected]

The command associated with this view / control.

UInt32 CP_View_Imp::fFlags [protected]

CP_ViewBackground* CP_View_Imp::fViewBackground [protected]

CP_DataValueSignal CP_View_Imp::fBoundsChangedSignal [protected]

CP_DataValueSignal CP_View_Imp::fShowSignal [protected]

Signal sent when the bounds of this view change.

CP_DataValueSignal CP_View_Imp::fHideSignal [protected]

Signal sent when the view is becoming visible.

CP_DataValueSignal CP_View_Imp::fActivateSignal [protected]

Signal sent when the view is becoming hidden.

CP_DataValueSignal CP_View_Imp::fDeactivateSignal [protected]

Signal sent when the view is becoming active.

CP_DataValueSignal CP_View_Imp::fEnableSignal [protected]

Signal sent when the view is becoming inactive.

CP_DataValueSignal CP_View_Imp::fDisableSignal [protected]

Signal sent when the view is becoming enabled.

CP_DataValueSlot CP_View_Imp::fShowSlot [protected]

Signal sent when the view is becoming disable.

CP_DataValueSlot CP_View_Imp::fHideSlot [protected]

Slot to show a view.

CP_DataValueSlot CP_View_Imp::fActivateSlot [protected]

Slot to hide a view.

CP_DataValueSlot CP_View_Imp::fDeactivateSlot [protected]

Slot to activate a view.

CP_DataValueSlot CP_View_Imp::fEnableSlot [protected]

Slot to deactivate a view.

CP_DataValueSlot CP_View_Imp::fDisableSlot [protected]

Slot to enable a view.

CP_Signals_Array* CP_Object::fSignals [protected, inherited]

CP_Slots_Array* CP_Object::fSlots [protected, inherited]

List of registered signals for this object.

FourCharCode CP_Object::fObjectID [protected, inherited]

List of registered slots for this object.

CPLAT_Begin_Namespace_CPLAT FourCharCode CP_Object::fObjectIDCount = 0 [static, protected, inherited]

Object identifier.

CP_Commands_Array* CP_M_CommandHandler::fCommands [protected, inherited]

CP_MenuSelectionSignal* CP_M_CommandHandler::fMennuSelectionSignal [protected, inherited]

List of commands managed by this class.

sender_set CP_SigSlot::CP_SlotObject::fSenders [protected, inherited]

CP_IDropSource* CP_M_DragSource::fIDropSource [protected, inherited]

CP_IDataObject* CP_M_DragSource::fIDataObject [protected, inherited]

Windows OLE IDropSource interface object.

FORMATETC* CP_M_DragSource::fDataFormats [protected, inherited]

Windows OLE IDataObject interface object.

DWORD CP_M_DragSource::fNumberFormats [protected, inherited]

Array of FORMATETC structure with desired formats.

CP_Enumerator* CP_M_DragSource::fEnumerator [protected, inherited]

Number of FORMATETC structures.

CP_DataStream CP_M_DragSource::fData [protected, inherited]

CP_Enumerator object.

CPLAT_Begin_Namespace_CPLAT CP_DragTarget_List * CP_M_DragTarget::fsDragTargetList = NULL [static, protected, inherited]

CP_M_DragTarget * CP_M_DragTarget::fsCurrentDragTarget = NULL [static, protected, inherited]

bool CP_M_DragTarget::fsDragHasLeftSender = false [static, protected, inherited]

CP_Window* CP_M_DragTarget::fWindow [protected, inherited]

bool CP_M_DragTarget::fDropAreaIsHilited [protected, inherited]

bool CP_M_DragTarget::fCanAcceptCurrentDrag [protected, inherited]

OSWindow CP_M_DragTarget::fTargetWindow [protected, inherited]

CDropTarget* CP_M_DragTarget::fDropTarget [protected, inherited]

Windows HWND for the target.

CP_Point CP_M_DragTarget::fDropPoint [protected, inherited]

OLE drop target interface object.

---

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

• CP_View_Imp.h
• CP_View_Imp.cpp

---