SRootWindow Class Reference

Root window class derived from SWindow. More...

#include <SHostWnd.h>

Inheritance diagram for SRootWindow:

Public Member Functions
	SRootWindow (SHostWnd *pHostWnd)
	Constructor for SRootWindow.
SHostWnd *	GetHostWnd () const
	Gets the pointer to the host window.
void	FireMenuCmd (int menuID)
	Fires a menu command event.
void	UpdateLayout () OVERRIDE
	Updates the layout of the window.
virtual HRESULT	SetAttribute (const SNS::SStringW &strAttribName, const SNS::SStringW &strValue, BOOL bLoading=FALSE)
Public Member Functions inherited from SWindow
	SWindow ()
	Constructor.
virtual	~SWindow ()
	Destructor.
BOOL	IsMsgHandled () const
	Checks if the message is handled.
void	SetMsgHandled (BOOL bHandled)
	Sets the message handled flag.
void	OnFinalRelease ()
	Called when the last reference to the object is released.
SWND	GetSwnd () SCONST OVERRIDE
	Retrieves the window handle.
ILayout *	GetLayout () OVERRIDE
	Retrieves the layout object associated with the window.
ILayoutParam *	GetLayoutParam () SCONST OVERRIDE
	Retrieves the layout parameter object associated with the window.
BOOL	SetLayoutParam (ILayoutParam *pLayoutParam) OVERRIDE
	Sets the layout parameter object for the window.
BOOL	IsFloat () SCONST OVERRIDE
	Checks if the window is floating.
BOOL	IsDisplay () SCONST OVERRIDE
	Checks if the window is displayed.
void	SetWindowText (LPCTSTR lpszText) OVERRIDE
	Sets the window text.
void	SetWindowTextU8 (LPCSTR lpszText) OVERRIDE
	Sets the window text using a UTF-8 string.
void	SetToolTipText (LPCTSTR pszText) OVERRIDE
	Sets the tooltip text for the window.
void	SetToolTipTextU8 (LPCSTR pszText) OVERRIDE
	Sets the tooltip text using a UTF-8 string.
BOOL	IsChecked () SCONST OVERRIDE
	Checks if the window is checked.
void	SetCheck (BOOL bCheck) OVERRIDE
	Sets the check state of the window.
BOOL	IsDisabled (BOOL bCheckParent=FALSE) SCONST OVERRIDE
	Checks if the window is disabled.
void	EnableWindow (BOOL bEnable, BOOL bUpdate=FALSE) OVERRIDE
	Enables or disables the window.
BOOL	IsVisible (BOOL bCheckParent=FALSE) SCONST OVERRIDE
	Checks if the window is visible.
void	SetVisible (BOOL bVisible, BOOL bUpdate=FALSE) OVERRIDE
	Sets the visibility of the window.
BOOL	IsMsgTransparent () SCONST OVERRIDE
	Checks if the window is message transparent.
ULONG_PTR	GetUserData () SCONST OVERRIDE
	Retrieves the user data associated with the window.
ULONG_PTR	SetUserData (ULONG_PTR uData) OVERRIDE
	Sets the user data for the window.
void	GetWindowRect (LPRECT prect) SCONST OVERRIDE
	Retrieves the bounding rectangle of the window.
BOOL	IsVideoCanvas () SCONST OVERRIDE
	Checks if the window is a video canvas.
void	GetVisibleRect (LPRECT prect) SCONST OVERRIDE
	Retrieves the visible rectangle of the window.
void	GetClientRect (LPRECT prect) SCONST OVERRIDE
	Retrieves the client rectangle of the window.
BOOL	IsContainPoint (POINT pt, BOOL bClientOnly) SCONST OVERRIDE
	Checks if the window contains a specified point.
void	DoColorize (COLORREF cr) OVERRIDE
	Applies colorization to the window.
COLORREF	GetColorizeColor () SCONST OVERRIDE
	Retrieves the colorization color of the window.
BOOL	Destroy () OVERRIDE
	Destroys the window.
void	BringWindowToTop () OVERRIDE
	Brings the window to the top of the Z-order.
UINT	GetChildrenCount () SCONST OVERRIDE
	Retrieves the number of child windows.
LRESULT	SSendMessage (UINT uMsg, WPARAM wParam=0, LPARAM lParam=0, BOOL *pbMsgHandled=NULL) OVERRIDE
	Sends a message to the window.
void	SDispatchMessage (UINT uMsg, WPARAM wParam=0, LPARAM lParam=0) OVERRIDE
	Dispatches a message to the window.
void	SetFocus () OVERRIDE
	Sets the focus to the window.
void	KillFocus () OVERRIDE
	Kills the focus from the window.
BOOL	IsFocused () SCONST OVERRIDE
	Checks if the window has focus.
void	Invalidate () OVERRIDE
	Invalidates the entire window.
void	InvalidateRect (LPCRECT lprect) OVERRIDE
	Invalidates a specific rectangle area of the window.
void	LockUpdate () OVERRIDE
	Locks updates to the window.
void	UnlockUpdate () OVERRIDE
	Unlocks updates to the window.
BOOL	IsUpdateLocked (BOOL bCheckParent=FALSE) SCONST OVERRIDE
	Checks if updates to the window are locked.
void	Update (BOOL bForce=FALSE) OVERRIDE
	Updates the window.
void	Move (LPCRECT prect) OVERRIDE
	Moves the window to a new position and size.
void	SetWindowRgn (IRegionS *pRgn, BOOL bRedraw=TRUE) OVERRIDE
	Sets the window region.
IRegionS *	GetWindowRgn () SCONST OVERRIDE
	Retrieves the window region.
void	SetWindowPath (IPathS *pPath, BOOL bRedraw=TRUE) OVERRIDE
	Sets the window path.
IPathS *	GetWindowPath () SCONST OVERRIDE
	Retrieves the window path.
BOOL	SetTimer (char id, UINT uElapse) OVERRIDE
	Sets a timer for the window.
BOOL	KillTimer (char id) OVERRIDE
	Kills a timer for the window.
SWND	GetCapture () SCONST OVERRIDE
	Retrieves the window that has captured the mouse.
SWND	SetCapture () OVERRIDE
	Sets the window to capture the mouse.
BOOL	ReleaseCapture () OVERRIDE
	Releases the mouse capture from the window.
void	SetAnimation (IAnimation *animation) OVERRIDE
	Sets an animation for the window.
IAnimation *	GetAnimation () SCONST OVERRIDE
	Retrieves the animation object associated with the window.
void	StartAnimation (IAnimation *animation) OVERRIDE
	Starts an animation for the window.
void	ClearAnimation () OVERRIDE
	Clears the animation for the window.
void	SetAlpha (BYTE byAlpha) OVERRIDE
	Sets the alpha value for the window.
BYTE	GetAlpha () SCONST OVERRIDE
	Retrieves the alpha value of the window.
void	SetMatrix (const IMatrix *mtx) OVERRIDE
	Sets the transformation matrix for the window.
void	GetMatrix (IMatrix *mtx) SCONST OVERRIDE
	Retrieves the transformation matrix of the window.
int	GetScale () SCONST OVERRIDE
	Retrieves the scale factor of the window.
BOOL	IsSiblingsAutoGroupped () SCONST OVERRIDE
	Checks if siblings are auto-grouped.
void	RequestRelayout () OVERRIDE
	Requests a relayout of the window.
void	UpdateLayout () OVERRIDE
	Updates the layout of the window.
UINT	OnGetDlgCode () SCONST OVERRIDE
	Retrieves the dialog code for the window.
BOOL	IsFocusable () SCONST OVERRIDE
	Checks if the window is focusable.
BOOL	IsClipClient () SCONST OVERRIDE
	Checks if client area clipping is enabled.
BOOL	IsLayoutDirty () SCONST OVERRIDE
	Checks if the layout is dirty.
IWindow *	GetNextLayoutIChild (const IWindow *pCurChild) SCONST OVERRIDE
	Retrieves the next layout child window.
void	UpdateChildrenPosition () OVERRIDE
	Updates the position of child windows.
IWindow *	GetIWindow (int uCode) SCONST OVERRIDE
	Retrieves a window based on a given code.
IWindow *	GetIChild (int iChild) SCONST OVERRIDE
	Retrieves a child window by index.
IWindow *	GetIParent () SCONST OVERRIDE
	Retrieves the parent window.
IWindow *	GetIRoot () SCONST OVERRIDE
	Retrieves the root window in the hierarchy.
BOOL	IsDescendant (const IWindow *pWnd) SCONST OVERRIDE
	Checks if a window is a descendant of this window.
BOOL	AdjustIZOrder (IWindow *pInsertAfter) OVERRIDE
	Adjusts the Z-order of the window.
void	InsertIChild (IWindow *pNewChild, IWindow *pInsertAfter=NULL) OVERRIDE
	Inserts a child window into the window tree.
BOOL	RemoveIChild (IWindow *pChild) OVERRIDE
	Removes a child window from the window tree.
BOOL	DestroyIChild (IWindow *pChild) OVERRIDE
	Destroys a child window.
void	DestroyAllChildren () OVERRIDE
	Destroys all child windows.
IWindow *	FindIChildByID (int nId) OVERRIDE
	Finds a child window by its ID.
IWindow *	FindIChildByName (LPCWSTR pszName) OVERRIDE
	Finds a child window by its name.
IWindow *	FindIChildByNameA (LPCSTR pszName) OVERRIDE
	Finds a child window by its name (ANSI version).
ISwndContainer *	GetContainer () OVERRIDE
	Retrieves the container associated with this window.
void	SetContainer (ISwndContainer *pContainer) OVERRIDE
	Sets the container for the window.
void	GetChildrenLayoutRect (RECT *prc) SCONST OVERRIDE
	Retrieves the layout rectangle of the children.
void	GetDesiredSize (SIZE *psz, int nParentWid, int nParentHei) OVERRIDE
	Retrieves the desired size of the window.
void	Move2 (int x, int y, int cx=-1, int cy=-1) OVERRIDE
	Moves the window to a new position and optionally resizes it.
int	GetWindowText (TCHAR *pBuf, int nBufLen, BOOL bRawText) OVERRIDE
	Retrieves the window text.
int	GetWindowTextU8 (IStringA *pStr, BOOL bRawText) OVERRIDE
	Retrieves the window text as a UTF-8 string.
void	SetEventMute (BOOL bMute) OVERRIDE
	Sets the event mute state.
DWORD	GetState () SCONST OVERRIDE
	Retrieves the current state of the window.
DWORD	ModifyState (DWORD dwStateAdd, DWORD dwStateRemove, BOOL bUpdate=FALSE) OVERRIDE
	Modifies the state of the window.
void	SetIOwner (IWindow *pOwner) OVERRIDE
	Sets the owner window.
IWindow *	GetIOwner () SCONST OVERRIDE
	Retrieves the owner window.
BOOL	CreateChildrenFromXml (LPCWSTR pszXml) OVERRIDE
	Creates child windows from XML.
BOOL	CreateChildrenFromResId (LPCTSTR pszResId) OVERRIDE
	Creates child windows from a resource ID.
BOOL	InitFromXml (IXmlNode *pNode) OVERRIDE
	Initializes the window from an XML node.
BOOL	GetAttribute (LPCWSTR pszName, IStringW *strValue) SCONST OVERRIDE
	Retrieves an attribute value from the window.
COLORREF	GetBkgndColor () SCONST OVERRIDE
	Retrieves the background color of the window.
IWindow *	GetISelectedSiblingInGroup () OVERRIDE
	Retrieves the selected sibling window in a group.
IWindow *	GetISelectedChildInGroup () OVERRIDE
	Retrieves the selected child window in a group.
SWND	SwndFromPoint (POINT *pt, BOOL bIncludeMsgTransparent=FALSE) SCONST OVERRIDE
	Retrieves the window handle at a specified point.
BOOL	FireEvent (IEvtArgs *evt) OVERRIDE
	Fires an event.
BOOL	FireCommand () OVERRIDE
	Fires a command event.
BOOL	FireCtxMenu (POINT pt) OVERRIDE
	Fires a context menu event.
BOOL	SubscribeEvent (DWORD evtId, const IEvtSlot *pSlot) OVERRIDE
	Subscribes to an event.
BOOL	UnsubscribeEvent (DWORD evtId, const IEvtSlot *pSlot) OVERRIDE
	Unsubscribes from an event.
HRESULT	QueryInterface (REFGUID id, IObjRef **ppRet) OVERRIDE
	Queries an interface.
BOOL	AddEvent (DWORD dwEventID, LPCWSTR pszEventHandlerName) OVERRIDE
	Adds an event handler.
BOOL	RemoveEvent (DWORD dwEventID) OVERRIDE
	Removes an event handler.
BOOL	SwndProc (UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT *lResult) OVERRIDE
	Processes a window message.
void	SetSwndProc (FunSwndProc swndProc) OVERRIDE
	Sets the window procedure.
HWND	GetHostHwnd () OVERRIDE
	Retrieves the host window handle.
ITimelineHandlersMgr *	GetTimelineHandlersMgr () OVERRIDE
	Retrieves the timeline handlers manager.
BOOL	RegisterDragDrop (IDropTarget *pDragTarget) OVERRIDE
	Registers a drop target for the window.
BOOL	UnregisterDragDrop () OVERRIDE
	Unregisters a drop target for the window.
BOOL	CreateCaret (HBITMAP pBmp, int nWid, int nHeight) OVERRIDE
	Creates a caret.
void	ShowCaret (BOOL bShow) OVERRIDE
	Shows or hides the caret.
void	SetCaretPos (int x, int y) OVERRIDE
	Sets the caret position.
IAccProxy *	GetAccProxy ()
	Retrieves the accessibility proxy for the window.
void	accNotifyEvent (DWORD dwEvt)
	Notifies an accessibility event.
PSWNDMSG	GetCurMsg (void) const
	Retrieves the current message being processed.
const ISwndContainer *	GetContainer () const
	Retrieves the container associated with this window.
SWindow *	GetWindow (int uCode) const
	Retrieves a window based on a given code.
SWindow *	GetChild (int iChild) const
	Retrieves a child window by index.
SWindow *	GetParent () const
	Retrieves the parent window.
SWindow *	GetRoot () const
	Retrieves the root window in the hierarchy.
SWindow *	GetNextLayoutChild (const SWindow *pCurChild) const
	Retrieves the next layout child after a specified child.
BOOL	AdjustZOrder (SWindow *pInsertAfter)
	Adjusts the Z-order of the window.
void	InsertChild (SWindow *pNewChild, SWindow *pInsertAfter=NULL)
	Inserts a child window into the window tree.
BOOL	RemoveChild (SWindow *pChild)
	Removes a child window from the window tree.
BOOL	DestroyChild (SWindow *pChild)
	Destroys a child window.
void	SetMatrix (const SMatrix &mtx)
	Sets the transformation matrix for the window.
virtual SStringT	GetWindowText (BOOL bRawText=FALSE)
	Retrieves the text of the window.
virtual SStringT	GetToolTipText ()
	Retrieves the tooltip text of the window.
SEventSet *	GetEventSet ()
	Retrieves the event set associated with the window.
const SwndStyle &	GetStyle () const
	Retrieves the style of the window.
SwndStyle &	GetStyle ()
void	SetOwner (SWindow *pOwner)
	Sets the owner of the window.
SWindow *	GetOwner () const
	Retrieves the current owner of the window.
UINT	GetTextAlign () const
	Retrieves the text alignment of the window.
CRect	GetWindowRect () const
	Retrieves the bounding rectangle of the window.
virtual CRect	GetClientRect () const
	Retrieves the client rectangle of the window.
SWindow *	FindChildByID (int nID, int nDeep=-1)
	Finds a child window by its ID.
template<class T>
T *	GetLayoutParamT ()
	Template method to cast layout parameters to a specific type.
template<class T>
T *	FindChildByID2 (int nID, int nDeep=-1)
	Finds a child window by its ID and casts it to a specific type.
SWindow *	FindChildByName (LPCWSTR strName, int nDeep=-1)
	Finds a child window by its name.
SWindow *	FindChildByName (LPCSTR strName, int nDeep=-1)
	Overloaded method to find a child window by its name (ANSI version).
template<class T>
T *	FindChildByName2 (LPCWSTR pszName, int nDeep=-1)
	Finds a child window by its name and casts it to a specific type.
template<class T>
T *	FindChildByName2 (LPCSTR pszName, int nDeep=-1)
	Overloaded method to find a child window by its name and cast it to a specific type (ANSI version).
template<class T>
T *	FindChildByClass (int nDeep=-1) const
	Recursively finds a child window by its class type.
virtual SIZE	MeasureContent (int nParentWid, int nParentHei)
	Measures the size of the content within the window.
virtual SIZE	MeasureChildren (int nParentWid, int nParentHei)
	Measures the size of all child windows.
virtual BOOL	UpdateToolTip (CPoint pt, SwndToolTipInfo &tipInfo)
	Handle tooltip updates.
virtual SWindow *	GetSelectedSiblingInGroup ()
	Get selected sibling in group.
virtual SWindow *	GetSelectedChildInGroup ()
	Get selected child in group.
virtual BOOL	CreateChildren (SXmlNode xmlNode)
	Create child windows from XML node.
virtual SWindow *	CreateChildByName (LPCWSTR pszName)
	Create child window by name.
virtual SStringW	tr (const SStringW &strSrc) const
	Translation function.
virtual SWND	SwndFromPoint (CPoint &pt, BOOL bIncludeMsgTransparent=false) const
	Get window from point.
virtual BOOL	OnNcHitTest (CPoint pt)
	Non-client area hit test.
virtual void	OnUpdateFloatPosition (const CRect &rcParent)
	Update floating window position.
virtual BOOL	NeedRedrawWhenStateChange ()
	Determine if redraw is needed on state change.
virtual void	GetTextRect (LPRECT pRect)
	Calculate text display rectangle.
virtual void	DrawText (IRenderTarget *pRT, LPCTSTR pszBuf, int cchText, LPRECT pRect, UINT uFormat)
	Draw text content.
virtual void	DrawFocus (IRenderTarget *pRT)
	Draw focus state.
virtual LPCWSTR	GetTrCtx () const
	Get translation context.
void	RedrawRegion (IRenderTarget *pRT, IRegionS *pRgn)
	Renders the content of the window and its child windows onto the RenderTarget.
IRenderTarget *	GetRenderTarget (LPCRECT pRc=NULL, GrtFlag gdcFlags=GRT_NODRAW, BOOL bClientRT=TRUE)
	Retrieves a memory DC compatible with the SWND window.
IRenderTarget *	GetRenderTarget (GrtFlag gdcFlags, IRegionS *pRgn)
	Retrieves a memory DC compatible with the SWND window.
void	ReleaseRenderTarget (IRenderTarget *pRT)
	Releases the RenderTarget obtained via GetRenderTarget.
void	PaintBackground (IRenderTarget *pRT, LPRECT pRc)
	Draws the background content of the window.
void	PaintForeground (IRenderTarget *pRT, LPRECT pRc, SWindow *pStartFrom=NULL)
	Draws the foreground content of the window.
void	BeforePaintEx (IRenderTarget *pRT)
	Prepares the drawing environment for the current window's RenderTarget, starting from the top-level window.
void	TransformPoint (CPoint &pt) const
	Transforms a point based on the current window's transformation matrix.
void	TransformPointEx (CPoint &pt) const
	Extends the transformation of a point.
BOOL	FireEvent (SEvtArgs &evt)
	Fires an event.
Public Member Functions inherited from TObjRefImpl< SObjectImpl< IWindow > >
	TObjRefImpl ()
	Constructor that initializes the reference count to 1.
virtual	~TObjRefImpl ()
	Virtual destructor.
long	AddRef () override
	Increments the reference count.
long	Release () override
	Decrements the reference count and deletes the object if the count reaches zero.
void	OnFinalRelease () override
	Deletes the object.
Public Member Functions inherited from SObjectImpl< IWindow >
	SObjectImpl ()
	Constructor.
BOOL	InitFromXml (IXmlNode *pXmlNode) OVERRIDE
	Initializes the object from an XML node.
LPCWSTR	GetName () SCONST OVERRIDE
	Retrieves the object's name.
LPCSTR	GetNameA () SCONST OVERRIDE
	Retrieves the object's name in ANSI format.
void	SetName (LPCWSTR pszName) OVERRIDE
	Sets the object's name.
int	GetID () SCONST OVERRIDE
	Retrieves the object's ID.
void	SetID (int nID) OVERRIDE
	Sets the object's ID.
HRESULT	AfterAttribute (LPCWSTR strAttribName, LPCWSTR strValue, BOOL bLoading, HRESULT hr) OVERRIDE
	Handles attribute processing after setting an attribute.
HRESULT	SetAttributeA (LPCSTR pszAttr, LPCSTR pszValue, BOOL bLoading) OVERRIDE
	Sets an attribute using ANSI strings.
HRESULT	SetAttribute (LPCWSTR pszAttr, LPCWSTR pszValue, BOOL bLoading) OVERRIDE
	Sets an attribute using wide strings.
virtual HRESULT	SetAttribute (const SStringW &strAttr, const SStringW &strValue, BOOL bLoading)
	Sets an attribute using wide strings.
HRESULT	ISetAttribute (const IStringW *strAttr, const IStringW *strValue, BOOL bLoading) OVERRIDE
	Sets an attribute using IStringW objects.
LPCWSTR	GetObjectClass () SCONST OVERRIDE
	Retrieves the object's class name.
int	GetObjectType () SCONST OVERRIDE
	Retrieves the object's type.
BOOL	IsClass (LPCWSTR lpszName) SCONST OVERRIDE
	Checks if the object is of a specific class.
BOOL	GetAttribute (LPCWSTR strAttr, IStringW *pValue) SCONST OVERRIDE
	Retrieves an attribute value.
void	OnInitFinished (IXmlNode *xmlNode) OVERRIDE
	Handles initialization completion.
void	SetAttrHandler (FunAttrHandler attrHandler) OVERRIDE
	Sets the attribute handler.

Protected Member Functions
void	OnAnimationStop (IAnimation *pAni) OVERRIDE
	Called when an animation stops.
virtual void	OnAnimationInvalidate (IAnimation *pAni, bool bErase)
	Called when an animation is invalidated.
virtual void	BeforePaint (IRenderTarget *pRT, SPainter &painter)
	Called before painting the window.
virtual void	AfterPaint (IRenderTarget *pRT, SPainter &painter)
	Called after painting the window.
virtual BOOL	IsLayeredWindow () const
	Checks if the window is a layered window.
virtual HRESULT	OnLanguageChanged ()
	Called when the language changes.
virtual void	OnScaleChanged (int scale)
	Called when the scale changes.
virtual void	RequestRelayout (SWND hSource, BOOL bSourceResizable)
	Requests a relayout of the window.
Protected Member Functions inherited from SWindow
IScriptModule *	GetScriptModule ()
	Retrieves the script module interface.
void	InvalidateRect (const CRect &rect, BOOL bFromThis=TRUE, BOOL bClip=FALSE)
	Invalidates a specific rectangle area of the window.
STransformation	GetTransformation () const
	Retrieves the current transformation matrix of the window.
BOOL	CreateChild (SXmlNode xmlChild)
	Creates a child window from an XML node.
void	CreateChilds (SXmlNode xmlNode)
	Creates multiple child windows from XML nodes.
void	OnAnimationStart (IAnimation *animation)
	Called when an animation starts.
void	OnAnimationStop (IAnimation *animation)
	Called when an animation stops.
void	OnAnimationRepeat (IAnimation *animation)
	Called when an animation repeats.
void	OnAnimationPauseChange (IAnimation *animation, BOOL bPaused)
	Called when the pause state of an animation changes.
virtual void	OnContentChanged ()
	Called when the content of the window changes.
virtual void	OnColorize (COLORREF cr)
	Adjusts the color tone of the window.
virtual BOOL	OnSetCursor (const CPoint &pt)
	Sets the cursor when the mouse hovers over the window.
virtual void	OnStateChanging (DWORD dwOldState, DWORD dwNewState)
	Called before the state of the window changes.
virtual void	OnStateChanged (DWORD dwOldState, DWORD dwNewState)
	Called after the state of the window changes.
virtual void	OnCaptureChanged (BOOL bCaptured)
	Called when the capture state of the window changes.
virtual BOOL	OnRelayout (const CRect &rcWnd)
	Handles window position changes during layout updates.
bool	IsCacheDirty () const
	Checks if the cache is marked as dirty.
void	MarkCacheDirty (bool bDirty)
	Marks the cache as dirty.
virtual bool	IsDrawToCache () const
	Checks if the window content is being drawn to the cache.
virtual void	DispatchPaint (IRenderTarget *pRT, IRegionS *pRgn, UINT iZorderBegin, UINT iZorderEnd)
	Handles paint dispatching for the window.
virtual void	OnCommitSurface (IRenderTarget *pRtDest, LPCRECT pRcDest, IRenderTarget *pRtSrc, LPCRECT pRcSrc, BYTE alpha)
	Commits surface changes.
virtual SWindow *	_FindChildByID (int nID, int nDeep)
	Finds a child window by ID.
virtual SWindow *	_FindChildByName (const SStringW &strName, int nDeep)
	Finds a child window by name.
SWindow *	_GetCurrentLayeredWindow ()
	Retrieves the host window for the current render layer.
bool	_ApplyMatrix (IRenderTarget *pRT, SMatrix &oriMtx)
	Applies a transformation matrix to the RenderTarget.
SMatrix	_GetMatrixEx () const
	Retrieves the extended transformation matrix for the window.
bool	_WndRectInRgn (const CRect &rc, const IRegionS *rgn) const
	Checks if the window rectangle lies within a specified region.
void	_PaintClient (IRenderTarget *pRT)
	Renders the client area of the window onto the RenderTarget.
void	_PaintNonClient (IRenderTarget *pRT)
	Renders the non-client area of the window onto the RenderTarget.
void	_RedrawNonClient ()
	Redraws the non-client area of the window.
void	_PaintRegion (IRenderTarget *pRT, IRegionS *pRgn, UINT iZorderBegin, UINT iZorderEnd)
	Renders a specific region of the window onto the RenderTarget.
void	_PaintChildren (IRenderTarget *pRT, IRegionS *pRgn, UINT iBeginZorder, UINT iEndZorder)
	Renders child windows within a specific Z-order range.
void	DrawDefFocusRect (IRenderTarget *pRT, CRect rc)
	Draws the default focus rectangle.
void	UpdateCacheMode ()
	Updates the cache mode for the window.
void	TestMainThread ()
	Tests if the current thread is the main UI thread.
void	GetScaleSkin (SAutoRefPtr< ISkinObj > &pSkin, int nScale)
	Retrieves a scaled skin object based on the current scale factor.
int	OnCreate (LPVOID)
	Handles the creation of the window.
void	OnSize (UINT nType, CSize size)
	Handles the resizing of the window.
void	OnDestroy ()
	Handles the destruction of the window.
BOOL	OnEraseBkgnd (IRenderTarget *pRT)
	Handles the erasing of the background.
void	OnPaint (IRenderTarget *pRT)
	Handles the painting of the window.
void	OnNcPaint (IRenderTarget *pRT)
	Handles the painting of the non-client area.
void	OnShowWindow (BOOL bShow, UINT nStatus)
	Handles showing or hiding the window.
void	OnEnable (BOOL bEnable, UINT nStatus)
	Handles enabling or disabling the window.
void	OnLButtonDown (UINT nFlags, CPoint pt)
	Handles the left mouse button down event.
void	OnLButtonDbClick (UINT nFlags, CPoint point)
	Handles the left mouse button double-click event.
void	OnLButtonUp (UINT nFlags, CPoint pt)
	Handles the left mouse button up event.
void	OnRButtonDown (UINT nFlags, CPoint point)
	Handles the right mouse button down event.
void	OnRButtonUp (UINT nFlags, CPoint point)
	Handles the right mouse button up event.
void	OnMouseHover (UINT nFlags, CPoint ptPos)
	Handles the mouse hover event.
void	OnMouseMove (UINT nFlags, CPoint pt)
	Handles the mouse move event.
void	OnMouseLeave ()
	Handles the mouse leave event.
BOOL	OnMouseWheel (UINT nFlags, short zDelta, CPoint pt)
	Handles the mouse wheel event.
LRESULT	OnMouseClick (UINT uMsg, WPARAM wParam, LPARAM lParam)
	Handles general mouse click events.
void	OnSetFocus (SWND wndOld)
	Handles gaining focus.
void	OnKillFocus (SWND wndFocus)
	Handles losing focus.
LRESULT	OnSetScale (UINT uMsg, WPARAM wParam, LPARAM lParam)
	Handles setting the scale of the window.
LRESULT	OnSetLanguage (UINT uMsg, WPARAM wParam, LPARAM lParam)
	Handles setting the language of the window.
LRESULT	OnSetColorize (UINT uMsg, WPARAM wParam, LPARAM lParam)
	Handles setting the colorization of the window.
LRESULT	OnUpdateFont (UINT uMsg, WPARAM wParam, LPARAM lParam)
	Handles updating the font of the window.
HRESULT	OnAttrVisible (const SStringW &strValue, BOOL bLoading)
	Handles the 'visible' attribute.
HRESULT	OnAttrEnable (const SStringW &strValue, BOOL bLoading)
	Handles the 'enable' attribute.
HRESULT	OnAttrDisplay (const SStringW &strValue, BOOL bLoading)
	Handles the 'display' attribute.
HRESULT	OnAttrCache (const SStringW &strValue, BOOL bLoading)
	Handles the 'cache' attribute.
HRESULT	OnAttrAlpha (const SStringW &strValue, BOOL bLoading)
	Handles the 'alpha' attribute.
HRESULT	OnAttrSkin (const SStringW &strValue, BOOL bLoading)
	Handles the 'skin' attribute.
HRESULT	OnAttrLayout (const SStringW &strValue, BOOL bLoading)
	Handles the 'layout' attribute.
HRESULT	OnAttrClass (const SStringW &strValue, BOOL bLoading)
	Handles the 'class' attribute.
HRESULT	OnAttrTrackMouseEvent (const SStringW &strValue, BOOL bLoading)
	Handles the 'trackMouseEvent' attribute.
HRESULT	OnAttrVideoCanvas (const SStringW &strValue, BOOL bLoading)
	Handles the 'videoCanvas' attribute.
HRESULT	OnAttrID (const SStringW &strValue, BOOL bLoading)
	Handles the 'id' attribute.
HRESULT	OnAttrName (const SStringW &strValue, BOOL bLoading)
	Handles the 'name' attribute.
HRESULT	OnAttrTip (const SStringW &strValue, BOOL bLoading)
	Handles the 'tip' attribute.
HRESULT	OnAttrText (const SStringW &strValue, BOOL bLoading)
	Handles the 'text' attribute.
HRESULT	DefAttributeProc (const SStringW &strAttribName, const SStringW &strValue, BOOL bLoading)
	Default attribute processing function.
virtual HRESULT	AfterAttribute (const SStringW &strAttribName, const SStringW &strValue, BOOL bLoading, HRESULT hr)
	Called after an attribute is processed.
virtual void	OnRebuildFont ()
	Called when the font of the window needs to be rebuilt.
virtual void	OnBeforeInsertChild (SWindow *pChild)
	Called before a child window is inserted into this window.
virtual void	OnAfterInsertChild (SWindow *pChild)
	Called after a child window has been inserted into this window.
virtual void	OnBeforeRemoveChild (SWindow *pChild)
	Called before a child window is removed from this window.
virtual void	OnAfterRemoveChild (SWindow *pChild)
	Called after a child window has been removed from this window.
virtual void	OnContainerChanged (ISwndContainer *pOldContainer, ISwndContainer *pNewContainer)
	Called when the container of the window changes.

Protected Attributes
SAutoRefPtr< IAnimation >	m_aniEnter
SAutoRefPtr< IAnimation >	m_aniExit
SHostWnd *	m_pHostWnd
Protected Attributes inherited from SWindow
SWND	m_swnd
	Member variables representing various properties of the window.
BOOL	m_bFloat
ISwndContainer *	m_pContainer
SEventSet	m_evtSet
SAutoRefPtr< ILayout >	m_pLayout
SAutoRefPtr< ILayoutParam >	m_pLayoutParam
SWindow *	m_pOwner
SWindow *	m_pParent
SWindow *	m_pFirstChild
SWindow *	m_pLastChild
SWindow *	m_pNextSibling
SWindow *	m_pPrevSibling
UINT	m_nChildrenCount
SWNDMSG *	m_pCurMsg
SwndStyle	m_style
STrText	m_strText
STrText	m_strToolTipText
SStringW	m_strTrCtx
UINT	m_uZorder
int	m_nUpdateLockCnt
BOOL	m_dwState
BOOL	m_bVisible
BOOL	m_bDisable
BOOL	m_bDisplay
BOOL	m_bClipClient
BOOL	m_bMsgTransparent
BOOL	m_bFocusable
BOOL	m_bDrawFocusRect
BOOL	m_bCacheDraw
BOOL	m_bCacheDirty
BOOL	m_bLayeredWindow
BOOL	m_isLoading
BOOL	m_bHoverAware
BOOL	m_bMsgHandled
LayoutDirtyType	m_layoutDirty
SAutoRefPtr< IRenderTarget >	m_cachedRT
SAutoRefPtr< IRegionS >	m_clipRgn
SAutoRefPtr< IPathS >	m_clipPath
SAutoRefPtr< ISkinObj >	m_pBgSkin
SAutoRefPtr< ISkinObj >	m_pNcSkin
ULONG_PTR	m_uData
SLayoutSize	m_nMaxWidth
COLORREF	m_crColorize
SAutoRefPtr< IAnimation >	m_animation
SAnimationHandler	m_animationHandler
STransformation	m_transform
bool	m_isAnimating
bool	m_isDestroying
PGETRTDATA	m_pGetRTData
SAutoRefPtr< IAttrStorage >	m_attrStorage
SAutoRefPtr< ICaret >	m_caret
FunSwndProc	m_funSwndProc
Protected Attributes inherited from TObjRefImpl< SObjectImpl< IWindow > >
LONG	m_cRef
	Reference count.
Protected Attributes inherited from SObjectImpl< IWindow >
SStringW	m_strName
int	m_nID
FunAttrHandler	m_attrHandler

Friends
class	SHostWnd

Additional Inherited Members
Static Public Member Functions inherited from SWindow
static SStringW	GetXmlText (const SXmlNode &xmlNode)
	Gets the XML text from a node.
Static Public Member Functions inherited from SObjectImpl< IWindow >
static int	GetClassType ()
	Retrieves the class type.
static LPCWSTR	GetClassName ()
	Retrieves the class name.
static LPCWSTR	GetClassAlias ()
	Retrieves the class alias.
static void	MarkAttributeHandled (SXmlAttr xmlAttr, bool bHandled)
	Marks an attribute as handled.
static bool	IsAttributeHandled (SXmlAttr xmlAttr)
	Checks if an attribute is handled.
Protected Types inherited from SWindow
enum	LayoutDirtyType { dirty_clean = 0 , dirty_self = 1 , dirty_child = 2 }
	Enumerates the types of layout dirty states. More...
typedef struct SWindow::GETRTDATA *	PGETRTDATA

Detailed Description

Root window class derived from SWindow.

This class represents the root window in the SOUI framework and manages various window behaviors and events.

Definition at line 187 of file SHostWnd.h.

Constructor & Destructor Documentation

SRootWindow()

SRootWindow::SRootWindow

(

SHostWnd *

pHostWnd

)

Constructor for SRootWindow.

Initializes the SRootWindow object with a pointer to the host window.

Parameters

pHostWnd

Pointer to the host window.

Definition at line 160 of file shostwnd.cpp.

Member Function Documentation

AfterPaint()

void SRootWindow::AfterPaint ( IRenderTarget * pRT, SPainter & painter )

protectedvirtual

Called after painting the window.

Parameters

pRT	Pointer to the render target.
painter	Painter object.

Reimplemented from SWindow.

Definition at line 219 of file shostwnd.cpp.

BeforePaint()

void SRootWindow::BeforePaint ( IRenderTarget * pRT, SPainter & painter )

protectedvirtual

Called before painting the window.

Parameters

pRT	Pointer to the render target.
painter	Painter object.

Reimplemented from SWindow.

Definition at line 202 of file shostwnd.cpp.

FireMenuCmd()

void SRootWindow::FireMenuCmd

(

int

menuID

)

Fires a menu command event.

Parameters

menuID

ID of the menu command to trigger.

Definition at line 289 of file shostwnd.cpp.

GetHostWnd()

SHostWnd * SRootWindow::GetHostWnd

(

)

const

Gets the pointer to the host window.

Returns

Pointer to the host window.

Definition at line 284 of file shostwnd.cpp.

IsLayeredWindow()

virtual BOOL SRootWindow::IsLayeredWindow ( ) const

inlineprotectedvirtual

Checks if the window is a layered window.

Returns

TRUE if the window is a layered window, FALSE otherwise.

Reimplemented from SWindow.

Definition at line 266 of file SHostWnd.h.

OnAnimationInvalidate()

void SRootWindow::OnAnimationInvalidate ( IAnimation * pAni, bool bErase )

protectedvirtual

Called when an animation is invalidated.

Parameters

pAni	Pointer to the animation object.
bErase	Flag indicating whether to erase the animation.

Reimplemented from SWindow.

Definition at line 168 of file shostwnd.cpp.

OnAnimationStop()

void SRootWindow::OnAnimationStop ( IAnimation * pAni )

protected

Called when an animation stops.

Overrides the base class method to handle animation stop events.

Parameters

pAni	Pointer to the animation object.

Definition at line 182 of file shostwnd.cpp.

OnLanguageChanged()

HRESULT SRootWindow::OnLanguageChanged ( )

protectedvirtual

Called when the language changes.

Returns

HRESULT indicating the success or failure of the operation.

Reimplemented from SWindow.

Definition at line 251 of file shostwnd.cpp.

OnScaleChanged()

void SRootWindow::OnScaleChanged ( int scale )

protectedvirtual

Called when the scale changes.

Parameters

scale

New scale factor.

Reimplemented from SWindow.

Definition at line 258 of file shostwnd.cpp.

RequestRelayout()

void SRootWindow::RequestRelayout ( SWND hSource, BOOL bSourceResizable )

protectedvirtual

Requests a relayout of the window.

Parameters

hSource	Source window handle.
bSourceResizable	Flag indicating if the source window is resizable.

Reimplemented from SWindow.

Definition at line 265 of file shostwnd.cpp.

SetAttribute()

virtual HRESULT SRootWindow::SetAttribute ( const SNS::SStringW & strAttribName, const SNS::SStringW & strValue, BOOL bLoading = FALSE )

inlinevirtual

Reimplemented from SWindow.

Definition at line 294 of file SHostWnd.h.

UpdateLayout()

void SRootWindow::UpdateLayout

(

)

Updates the layout of the window.

Overrides the base class method to update the layout.

Definition at line 224 of file shostwnd.cpp.

Friends And Related Symbol Documentation

SHostWnd

friend class SHostWnd

friend

Definition at line 191 of file SHostWnd.h.

Member Data Documentation

m_aniEnter

SAutoRefPtr<IAnimation> SRootWindow::m_aniEnter

protected

Definition at line 301 of file SHostWnd.h.

m_aniExit

SAutoRefPtr<IAnimation> SRootWindow::m_aniExit

protected

Definition at line 301 of file SHostWnd.h.

m_pHostWnd

SHostWnd* SRootWindow::m_pHostWnd

protected

Definition at line 303 of file SHostWnd.h.

---

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

• SOUI/include/core/SHostWnd.h
• SOUI/src/core/shostwnd.cpp