Window that drives the main interface. More...

#include <pawscontrolwindow.h>

Public Member Functions
void	AddWindow (csString wndName, csString btnName)
	Creates a new WBName structure to hold window and button status. More...

bool	Contains (int x, int y)
	Determines if the coordinates are within this widget. More...

pawsButton *	FindButtonFromWindow (csString wndName)
	The find window and find button methods are used to match a button to it's related window. More...

pawsControlledWindow *	FindWindowFromButton (csString btnName)
	The find window and find button methods are used to match a button to it's related window. More...

Icon *	GetIcon (csString btnName)
	Matchs the button name to the icon that represents it on the display. More...

csString	getWindowInfo (csString widgetStr)
	Used to get the size and position of windows from a command. More...

csString	getWindowNames ()
	Used to get all names and alternative names of windows from a command. More...

void	HandleQuit ()
	When the quit button is pressed this method displays the yes/no dialog box to confirm that a user really wants to quit. More...

bool	HandleWindow (csString widgetStr)
	Used for generic controlled window behavior when a window's button is pressed. More...

bool	HandleWindowName (csString widgetStr)
	Used for generic controlled window behavior when a window's is called Displays a window that is hidden when asked for by a command. More...

void	Hide ()
	Makes widget invisible and removes focus if widget has current focus. More...

bool	hideWindow (csString widgetStr)
	Used to hide a window. More...

bool	hideWindowName (csString widgetStr)
	Used to hide a window from a command. More...

void	NextStyle ()
	Advances through the available styles when a users clicks the right mouse button in the control window. More...

bool	OnButtonReleased (int mouseButton, int keyModifier, pawsWidget *reporter)
	Called whenever a button is released. More...

bool	OnChildMouseEnter (pawsWidget *child)
	Called when mouse enters a child widget. More...

bool	OnChildMouseExit (pawsWidget *child)
	Called when a mouse exits a child widget. More...

bool	OnMouseEnter ()
	Called whenever the mouse enters this widget. More...

bool	OnMouseExit ()
	Called whenever the mouse leaves this widget. More...

	pawsControlWindow ()

	pawsControlWindow (const pawsControlWindow &origin)

bool	PostSetup ()
	This is called after the widget and all of it's children have been created. More...

void	Register (pawsControlledWindow *window)
	When a new window registers make an entry for them in our list. More...

bool	setWindowPositionName (csString widgetStr, int x, int y)
	Used to set the position of windows from a command. More...

bool	setWindowSizeName (csString widgetStr, int width, int height)
	Used to set the size of windows from a command. More...

void	Show ()
	Makes widget visible and brings it to the front. More...

bool	showWindow (csString widgetStr)
	Used to show a window. More...

bool	showWindowName (csString widgetStr)
	Used to show a window from a command. More...

void	Toggle ()
	Toggle a window and it's children from hidden to visible or back depending on the window state when called. More...

void	WindowClose (pawsWidget *wnd)
	Changes the icon IsActive flag to FALSE and displays the proper background for it when a window is closed. More...

void	WindowOpen (pawsWidget *wnd)
	Changes the icon IsActive flag to TRUE and displays the proper background for it when a window is opened. More...

virtual	~pawsControlWindow ()

Public Member Functions inherited from pawsWidget
void	AddChild (pawsWidget *widget)
	Add a child widget to this widget. More...

void	AddChild (size_t Index, pawsWidget *widget)
	Add a child widget to this widget at a specified position. More...

virtual void	BringToTop (pawsWidget *widget)
	Move this widget up the z order to the top. More...

virtual double	CalcFunction (MathEnvironment env, const char functionName, const double *params)

virtual void	CenterTo (int x, int y)
	Move this widget so that its center is at given location. More...

virtual void	CenterToMouse ()
	Move this widget so that its center is at mouse pointer, but it is fully on screen. More...

void	ChangeFontSize (float newSize)
	Change font to new size and reload font to make it take effect. More...

virtual bool	CheckButtonPressed (int button, int modifiers, pawsWidget *pressedWidget)
	Test button for activity. More...

virtual bool	CheckButtonReleased (int button, int modifiers, pawsWidget *pressedWidget)
	Test button for activity. More...

virtual bool	CheckKeyHandled (int)
	Allow pawsButton to simulate button pushes based on keypresses. More...

void	ClearBackgroundColor ()

void	ClearMaskingImage ()
	Clears the masking image. More...

csRect	ClipRect ()
	This returns the current clipping rectangle. More...

void	ClipToParent (bool allowForBackgroundBorder)
	Determines clipping area to use. More...

virtual void	Close ()
	Simply calls Hide() unless overidden. More...

virtual void	CreateWidgetConfigWindow ()
	Creates a popup window that the user can use to adjust the settings of this window. More...

virtual void	DeleteChild (pawsWidget *widget)
	Removes the widget from list of children and destructs it. More...

void	DeleteYourself ()
	Removes and destructs itself. More...

virtual void	DestroyWidgetConfigWindow ()
	Called by ApplyAlphaOnChildren to remove the config window to prevent weird stuff. More...

virtual void	Draw ()
	Draws the widget and all of it's children. More...

virtual void	Draw3D (iGraphics3D *)

virtual void	DrawBackground ()
	Draws the background with a color or an image. More...

virtual void	DrawChildren ()
	Draws all children marked visible. More...

void	DrawForeground ()
	Does the second part of the drawing drawing the background of the window. More...

virtual void	DrawMask ()
	Draws the mask picture. More...

virtual void	DrawToolTip (int x, int y)
	This draws the tool tip if a widget is visible and a tool tip is available. More...

void	DrawWidgetText (const char *text, int x, int y, int style=-1)
	Draw text in the widget at specified location. More...

bool	DrawWindow ()
	Does the first part of the drawing. More...

virtual void	Dump (csString tab="")
	Prints the widget names for the widget and all it's children. More...

const char *	FindDefaultWidgetStyle (const char *factoryName)

pawsWidget *	FindWidget (const char *name, bool complain=true)
	Find a child widget of this widget. More...

pawsWidget *	FindWidget (int id, bool complain=true)
	Find a child widget of this widget. More...

pawsWidget *	FindWidgetXMLBinding (const char *xmlbinding)
	Find a child widget of this widget with the given XML binding. More...

void	FormatToolTip (const char *fmt,...)
	Changes the format of a tool tip. More...

int	GetActualHeight (int myValue=-1)
	Returns the actual Height assuming the passed value was in 800x600 resolution. More...

int	GetActualWidth (int myValue=-1)
	Returns the actual width assuming the passed value was in 800x600 resolution. More...

csString	GetBackground ()
	Retrieve the background image name. More...

virtual pawsBorder *	GetBorder ()
	This returns the border created by UseBorder(). More...

virtual int	GetBorderColour (int which)
	Get the color for this widgets border. More...

virtual int	GetBorderStyle ()
	This returns the BORDER_BUMP style. More...

pawsWidget *	GetChild (size_t i)
	Used if you need to loop through the children of a widget. More...

size_t	GetChildrenCount ()
	Used if you need to loop through the children of a widget. More...

const char *	GetCloseName ()
	Returns the closeName of this widget. More...

virtual csRect	GetDefaultFrame ()
	Returns the default csRect. More...

iWidgetData *	GetExtraData ()
	Grabs extra data stored in the widget. More...

float	GetFadeSpeed ()
	Gets the fading speed. More...

int	GetFadeVal ()
	Gets the fade value of this widget. More...

const char *	GetFilename ()
	Returns the filename. More...

virtual bool	GetFocusOverridesControls () const
	Test if the widget should intercept all key presses. More...

iFont *	GetFont (bool scaled=true)
	Gets the current font as an iFont. More...

virtual int	GetFontColour ()
	Gets the current font color. More...

int	GetFontShadowColour ()
	Gets the current shadow color. More...

float	GetFontSize ()
	Gets the current font size. More...

int	GetFontStyle ()
	Gets the current font style. More...

int	GetID ()
	Gets the id of a widget. More...

int	GetLogicalHeight (int myValue)

int	GetLogicalWidth (int myValue)

int	GetMaxAlpha ()
	Gets the maximum alpha value of this widget. More...

int	GetMinAlpha ()
	Gets the minimim alpha value of this widget. More...

void	GetMinSize (int &width, int &height)

const char *	GetName ()
	Get the name of this widget. More...

pawsWidget *	GetParent ()
	Get this widget's parent. More...

csString	GetPathInWidgetTree ()
	Returns textual description of path to our widget through the widget tree. More...

virtual double	GetProperty (MathEnvironment env, const char ptr)

virtual csRect	GetScreenFrame ()
	Returns the csRect that defines widget area. More...

csString &	GetToolTip ()
	Gets the text from a tool tip. More...

const char *	GetType ()
	Gets the current factory type. More...

csRect	GetWidgetTextRect (const char *text, int x, int y, int style=-1)
	Get the rectangle containing the text DrawWidgetText will produce. More...

virtual const csString &	GetXMLBinding ()
	Get the xml nodes of this widget. More...

virtual bool	HasFocus ()
	Test focus of the widget. More...

virtual void	Ignore (bool ig)

bool	Includes (pawsWidget *widget)
	Returns true if widget equals this, or widget is a child of this. More...

bool	IsAlwaysOnTop ()
	Tests value of this widgets alwaysOnTop flag. More...

bool	IsChildOf (pawsWidget *someParent)
	Returns true, if this widget is the child of 'someParent'. More...

bool	IsConfigurable ()
	Tests if widget settings (alpha, fade, etc) are configurable. More...

bool	isFadeEnabled ()
	Gets the fade status of this widget. More...

bool	IsIndirectChild (pawsWidget *widget)
	Returns true, if 'widget' is child of our widget, even if it is indirect. More...

bool	IsResizable ()
	Test widget to see if it is resizable. More...

bool	isScalingFont ()
	Returns whether or not font is being auto-scaled. More...

bool	IsVisible ()
	Is the widget currently set visible? More...

virtual bool	Load (iDocumentNode *node)
	Load a widget based on its <widget></widget> tag. More...

virtual bool	LoadAttributes (iDocumentNode *node)
	Load standard widget attributes based on its <widget></widget> tag. More...

virtual bool	LoadChildren (iDocumentNode *node)
	Load widget children based on subtags of its <widget></widget> tag. More...

virtual bool	LoadEventScripts (iDocumentNode *node)
	Load event scripts for this widget. More...

bool	LoadFromFile (const csString &fileName)
	Parses XML file 'fileName', finds first widget tag and Load()s itself from this tag. More...

virtual csRect	LoadPositions ()
	Get the position of this widget that was stored in a cfg file. More...

virtual void	LoadSettings ()
	Loads current widget settings from an XML file. More...

void	MakeFullyVisible ()
	If some part of the widget is not within the rectangle of its parent, then the widget is moved inside (if it is small enough). More...

virtual void	MouseOver (bool value)
	Sets hasMouseFocus. More...

virtual void	MoveDelta (int dx, int dy)
	Move a widget by a delta amount. More...

virtual void	MoveTo (int x, int y)
	Moves this widget and all of its children to a new screen location. More...

bool	NeedsRender () const
	Whether we need to r2t. More...

virtual void	NewSubscription (const char *dataname)

virtual bool	OnButtonPressed (int button, int keyModifier, pawsWidget *widget)
	Called whenever a button is pressed. More...

virtual bool	OnChange (pawsWidget *widget)
	Called whenever a widget is selected. More...

virtual bool	OnClipboard (const csString &content)
	Process Clipboard content, as a response to RequestClipboardContent. More...

virtual bool	OnDoubleClick (int button, int modifiers, int x, int y)
	Manage mouse double click event. More...

virtual bool	OnGainFocus (bool=true)
	Changes hasFocus to TRUE and reports status to parent. More...

virtual bool	OnJoypadDown (int key, int modifiers)
	Process joypadDown messages. More...

virtual bool	OnKeyDown (utf32_char keyCode, utf32_char keyChar, int modifiers)
	Process keydown messages. More...

virtual void	OnListAction (pawsListBox *selected, int status)
	Called whenever an item in a child list box is selected. More...

virtual void	OnLostFocus ()
	Sets hasFocus false and notifys parent. More...

virtual bool	OnMenuAction (pawsWidget *widget, const pawsMenuAction &action)
	Called whenever a menu action occurs. More...

virtual bool	OnMouseDown (int button, int modifiers, int x, int y)
	Manage mouse down event to test for and apply window changes. More...

virtual bool	OnMouseUp (int button, int modifiers, int x, int y)
	Manage mouse up event. More...

virtual void	OnResize ()
	Sets the new position of the close button. More...

virtual bool	OnScroll (int scrollDirection, pawsScrollBar *widget)
	Called whenever a window is scrolled. More...

virtual bool	OnSelected (pawsWidget *widget)
	Called whenever a widget is selected. More...

virtual void	OnUpdateData (const char *, PAWSData &)

virtual bool	ParentDraw () const
	Whether to draw via the parent-child draw tree. More...

	pawsWidget ()

	pawsWidget (const pawsWidget &origin)

virtual void	PerformAction (const char *action)
	Does an action based on this string. More...

void	RecalcScreenPositions ()
	This re-calculates a widget's on screen position to draw based on it's relative position and parent screen location. More...

void	ReloadWidget ()
	Reloads widget from XML file. More...

void	RemoveChild (pawsWidget *widget)
	Removes the widget from list of children but does NOT destruct it. More...

void	RemoveTitle ()

virtual void	ResetToDefaultFrame ()
	Resets the position, width and height to the default position. More...

virtual void	Resize (int flags)
	Resize a widget based on the current mouse position. More...

virtual void	Resize (int dx, int dy, int flags)
	Resize a widget by a delta amount. More...

virtual void	Resize ()
	Resize a widget based on it's parent's size. More...

void	RunScriptEvent (PAWS_WIDGET_SCRIPT_EVENTS event)
	Executes any pawsScript associated with the given event. More...

virtual void	SavePosition ()
	Saves the position of this widget to the config file. More...

virtual void	SaveSettings ()
	Saves current widget settings to an XML file. More...

virtual bool	SelfPopulate (iDocumentNode *node)
	This function allows a widget to fill in its own contents from an xml node supplied and calls the same function for all children. More...

virtual bool	SelfPopulateXML (const char *xmlstr)
	This function parses the xml string and calls SelfPopulate with the resulting DOM structure if valid. More...

virtual void	SendToBottom (pawsWidget *widget)
	Move this widget down the z order to the bottom. More...

void	SetAlwaysOnTop (bool value)
	Sets value of this widgets alwaysOnTop flag. More...

virtual void	SetAttachFlags (int flags)
	Modify attachFlags to control widget construction. More...

virtual void	SetBackground (const char *imageName)
	Sets the background image, logs error if NULL. More...

virtual void	SetBackgroundAlpha (int alphaValue)
	Sets the alpha level of the background. More...

void	SetBackgroundColor (int r, int g, int b)
	Sets the background color. More...

void	SetColour (int newColour=-2)
	Set text color. More...

void	SetContextMenu (const csString &fileName)
	Sets name of the PAWS xml-file that describes context menu of our widget. More...

void	SetDefaultToolTip ()
	Sets the tool tip to the one defined in the XML. More...

void	SetExtraData (iWidgetData *data)
	Stores extra data into this widget. More...

void	SetFactory (const char *myfactory)
	Sets the type of factory. More...

void	SetFade (bool value)
	Used to control the fading feature of the widget. More...

void	SetFadeSpeed (float speed)
	Sets the fading speed. More...

void	SetFilename (const char *name)
	Changes filename to the name provided. More...

void	SetFont (const char *fontName, int Size=0)
	Set font to use programmatically. More...

void	SetFontScaling (bool value)
	Used to control the font scaling of the widget. More...

void	SetFontStyle (int style)
	Sets the current font style. More...

virtual void	SetForceSize (int newWidth, int newHeight)
	Same as above, but does not resize children. More...

void	SetID (int newID)
	Change the id of a widget. More...

void	SetMaskingImage (const char *image)
	Sets a masking image which will be drawn after the normal stuff. More...

void	SetMaxAlpha (int value)
	Sets the maximum alpha of this widget. More...

void	SetMaxSize (int width, int height)
	Set the max size for height and width. More...

void	SetMinAlpha (int value)
	Sets the minimim alpha of this widget. More...

void	SetMinSize (int width, int height)
	Set the minimum height and width to protect the widget from negatives. More...

void	SetModalState (bool isModal)
	Registers mode with the windowManager. More...

void	SetMovable (bool value)
	Makes a widget movable. More...

void	SetName (const char *newName)
	Set the name of this widget. More...

void	SetNeedsRender (bool needs)
	Marks that we need to r2t. More...

void	SetParent (pawsWidget *widget)
	Set the owner of this widget. More...

virtual void	SetProperty (const char *ptr, double value)

virtual void	SetRelativeFrame (int x, int y, int width, int height)
	Set the size of this widget and it's position relative to the parent. More...

virtual void	SetRelativeFramePos (int x, int y)
	Set the position of this widget relative to the parent. More...

virtual void	SetRelativeFrameSize (int width, int height)
	Sets defaultFrame and screenFrame size attributes. More...

void	SetResizeShow (bool v)
	Sets the showResize flag, controlling if the resize widget should be drawn. More...

virtual void	SetSize (int newWidth, int newHeight)
	Set the size of a particlar widget. More...

void	SetTitle (const char *title)
	Sets the border title of this widget. More...

bool	SetTitle (const char text, const char image, const char align, const char close_button, const bool shadowTitle=true)
	Sets up the title bar for the widget. More...

void	SetToolTip (const char *text)
	Changes the text for a tool tip. More...

virtual bool	Setup (iDocumentNode *)
	Setup this widget. More...

void	SetVisibility (bool visible)
	Make the widget visible or hides it. More...

virtual void	SetXMLBinding (csString &xmlbinding)
	Sets the xml nodes of this widget. More...

virtual void	ShowBehind ()
	Makes widget visible and brings it to the front but behind widget with current focus. More...

virtual void	StopResize ()
	Called once the mouse up is done after resizing a widget. More...

const char *	ToString ()

virtual void	UseBorder (const char *style=0)
	Creates a new border and links it to the widget. More...

virtual pawsWidget *	WidgetAt (int x, int y)
	Locate a widget that is at these screen coordindates. More...

virtual	~pawsWidget ()

Public Member Functions inherited from iPAWSSubscriber
virtual	~iPAWSSubscriber ()

Public Member Functions inherited from iScriptableVar
virtual	~iScriptableVar ()

Additional Inherited Members
Public Attributes inherited from pawsWidget
csArray< csString >	publishList

Protected Member Functions inherited from pawsWidget
int	CalcChildPosition (pawsWidget *child)
	Calculates the right position in array of children for a given child (depends on always-on-top state). More...

bool	CreateContextMenu ()
	Creates context menu from file ('contextMenuFile' attribute) More...

int	GetAttachFlag (const char *flag)
	Convert from string flag to int flag. More...

void	LoadBorderColours (iDocumentNode *node)
	Loads custom border color preferences. More...

bool	ReadDefaultWidgetStyles (iDocumentNode *node)

int	ResizeFlags (int mouseX, int mouseY)
	This will check to see if the mouse is over the resize hot spot. More...

void	SetCloseButtonPos ()
	Gets button from widget and sets it's location. More...

Protected Attributes inherited from pawsWidget
int	alpha
	The original background alpha. More...

int	alphaMin
	The minimum background alpha. More...

bool	alwaysOnTop
	Is this windows painted on top of other windows. More...

int	attachFlags
	The attachpoints for when a resize takes place. More...

int	bgColour
	Stores the bgColour for this widget. More...

csRef< iPawsImage >	bgImage
	Background image. More...

pawsBorder *	border
	border created by GetBorder(). More...

int	borderColours [5]
	Custom border colors for this window. More...

bool	borderTitleShadow
	whether the title in the border should be shadow font More...

csArray< pawsWidget * >	children
	The child widgets. More...

csRect	clipRect
	Current clipping rectangle. More...

pawsButton *	close_widget
	Used in SetTitle() for the new close button. More...

csString	closeName
	Old name of the widget with "_close" appended by SetName(). More...

bool	configurable
	Determines if the settings (alpha, fade, etc) of this widget are configurable. More...

pawsMenu *	contextMenu
	Existing context menu of the widget. More...

csString	contextMenuFile
	Path to the file that describes context menu of our widget (invoked by mouse right-click). More...

int	defaultFontColour
	Optional color to use when drawing text with this widget. More...

int	defaultFontShadowColour
	Optional color to use when doing text dropshadows. More...

float	defaultFontSize
	Default font size. More...

csRect	defaultFrame
	The default frame for the widget. More...

csString	defaultToolTip
	Default tool tip string for the widget. More...

csHash< csString, csString >	defaultWidgetStyles

iWidgetData *	extraData
	Holds any extra data the widget may need. More...

csString	factory
	factory name More...

bool	fade
	Set to false to disable fading. More...

float	fadeSpeed
	The speed of the fading process. More...

float	fadeVal
	The direction and percentage of current fade in progress. More...

csString	filename
	filename to load from or save to. More...

csString	fontName
	Name of currently selected font. More...

float	fontSize
	Current font size. More...

int	fontStyle
	Current font style. More...

csRef< iGraphics2D >	graphics2D
	The 2D graphics interface. More...

bool	hasBorderColours
	Flag to indicate using custom border colors. More...

bool	hasFocus
	Flag for widget focus. More...

bool	hasMouseFocus
	Flag for mouse over behavior. More...

int	id
	The id of the widget. More...

bool	ignore
	Flag determines if WidgetAT() ignores this widget. More...

bool	isResizable
	Determines if this widget can be resized by user. More...

bool	keepaspect
	Enforce keeping the default aspect ratio when resizing. More...

int	margin
	Stores margin value. Used in LoadAttributes(). More...

csRef< iPawsImage >	maskImage
	Masking image, used for nice-looking stuff. More...

int	max_height
	Defines the maximum height that the widget can be. More...

int	max_width
	Defines the maximum width that the widget can be. More...

int	min_height
	Defines the minimum height that the widget can be. More...

int	min_width
	Defines the minimum width that the widget can be. More...

bool	movable
	Determines if this widget is movable. More...

csRef< iFont >	myFont
	Optional font to use when drawing this widget. More...

csString	name
	The name of this widget. More...

bool	needsRender
	Whether we need to do a r2t update. More...

pawsWidget *	onEnter
	Widget to call if enter is pressed. More...

bool	overwrite_subscription
	Flag of whether OnUpdateData should overwrite the previous value or add to it. More...

pawsWidget *	parent
	This widget's parent. More...

bool	parentDraw
	Whether to draw this widget (different from visible, used to decide if Draw() is called via parent-child tree). More...

bool	resizeToScreen
	Determines if this widget should be auto resized with screen resolution. More...

bool	saveWidgetPositions
	Determines if this widget should write/load it's position from a config file. More...

bool	scaleFont
	Determines whether or not to scale font when a widget it resized. More...

csRect	screenFrame
	The screen area of the widget. More...

pawsScript *	scriptEvents [PW_SCRIPT_EVENT_COUNT]

bool	showOnMouseOver
	Stores status of showOnMouseOver. More...

csString	showOnMouseOver_image
	Stores the bgimage name if showOnMouseOver is true. More...

bool	showResize
	If the resize widget should be drawn. More...

csString	subscribedVar
	The variable that this widget is subscribed to. More...

csString	subscription_format

csArray< pawsWidget * >	taborder
	Contains the children for tabbing. More...

pawsTitle *	titleBar
	reference to titleBar object, if any More...

csString	toolTip
	Tooltip to be displayed. More...

bool	visible
	Flag to determine visiblity. More...

csString	xmlbinding
	Used in the SelfPopulate functions to map to xml nodes for each widget. More...

Detailed Description

Window that drives the main interface.

This widget controls the behavior of the main toolbar and the interaction with the various windows it controls.

Definition at line 55 of file pawscontrolwindow.h.

Constructor & Destructor Documentation

pawsControlWindow::pawsControlWindow ( )

virtual pawsControlWindow::~pawsControlWindow ( )

virtual

pawsControlWindow::pawsControlWindow ( const pawsControlWindow & origin )

inline

Definition at line 60 of file pawscontrolwindow.h.

Member Function Documentation

void pawsControlWindow::AddWindow	(	csString	wndName,
		csString	btnName
	)

Creates a new WBName structure to hold window and button status.

Parameters

wndName	The name of the window to add.
btnName	The name of the button associated with the window.

bool pawsControlWindow::Contains	(	int	x,
		int	y
	)

virtual

Determines if the coordinates are within this widget.

Typically the border or screenFrame.

Parameters

x	The x screen position.
y	The y screen position.

Returns: TRUE if yes otherwise FALSE

Reimplemented from pawsWidget.

pawsButton* pawsControlWindow::FindButtonFromWindow ( csString wndName )

The find window and find button methods are used to match a button to it's related window.

If you have the window name you can find the button.

Parameters

wndName The window name who's button you need.

pawsControlledWindow* pawsControlWindow::FindWindowFromButton ( csString btnName )

The find window and find button methods are used to match a button to it's related window.

If you have the button name you can find the window.

Parameters

btnName The button name who's window you need.

Icon* pawsControlWindow::GetIcon ( csString btnName )

Matchs the button name to the icon that represents it on the display.

Parameters

btnName The name to match.

csString pawsControlWindow::getWindowInfo ( csString widgetStr )

Used to get the size and position of windows from a command.

Parameters

widgetStr The window that should return its info or "all"

Returns: a string containing the requested info

csString pawsControlWindow::getWindowNames ( )

Used to get all names and alternative names of windows from a command.

Returns: a string containing all the window names

void pawsControlWindow::HandleQuit ( )

When the quit button is pressed this method displays the yes/no dialog box to confirm that a user really wants to quit.

bool pawsControlWindow::HandleWindow ( csString widgetStr )

Used for generic controlled window behavior when a window's button is pressed.

Displays a window that is hidden when it's button is pressed. Hides a window that is currently diplayed.

Parameters

widgetStr The window to handle.

Returns: TRUE if it makes it visible, returns FALSE if it made it invisible or error.

bool pawsControlWindow::HandleWindowName ( csString widgetStr )

Used for generic controlled window behavior when a window's is called Displays a window that is hidden when asked for by a command.

Hides a window that is currently diplayed.

Parameters

widgetStr The window to handle.

Returns: TRUE if the toggle was possible, returns FALSE if it was not found.

void pawsControlWindow::Hide ( )

virtual

Makes widget invisible and removes focus if widget has current focus.

Sets visible FALSE, hides border if present and then if focused when called it calls SetCurrentFocusedWidget(NULL).

Reimplemented from pawsWidget.

bool pawsControlWindow::hideWindow ( csString widgetStr )

Used to hide a window.

If the window was already hidden nothing happens.

Parameters

widgetStr The window to show

Returns: FALSE in case of an error otherwise TRUE

bool pawsControlWindow::hideWindowName ( csString widgetStr )

Used to hide a window from a command.

If the window was already hidden nothing happens.

Parameters

widgetStr The window to hide (command form, translated to the actual window name by the function)

Returns: FALSE in case of an error otherwise TRUE

void pawsControlWindow::NextStyle ( )

Advances through the available styles when a users clicks the right mouse button in the control window.

bool pawsControlWindow::OnButtonReleased	(	int	button,
		int	keyModifier,
		pawsWidget *	widget
	)

virtual

Called whenever a button is released.

Parameters

button	The button released.
keyModifier	Modifier key in effect.
widget	The widget the button belongs to.

Returns: bool Parent's result or FALSE if no parent.

Reimplemented from pawsWidget.

bool pawsControlWindow::OnChildMouseEnter ( pawsWidget * child )

virtual

Called when mouse enters a child widget.

If child wants to inform parent.

Parameters

child The child widget.

Returns: true

Reimplemented from pawsWidget.

bool pawsControlWindow::OnChildMouseExit ( pawsWidget * child )

virtual

Called when a mouse exits a child widget.

If child wants to inform parent.

Parameters

child The child widget.

Returns: bool Parent's result or TRUE if no parent.

Reimplemented from pawsWidget.

bool pawsControlWindow::OnMouseEnter ( )

virtual

Called whenever the mouse enters this widget.

Returns: bool Parent's result or TRUE if no parent.

Remarks: Acts recursively on it's parents.

Reimplemented from pawsWidget.

bool pawsControlWindow::OnMouseExit ( )

virtual

Called whenever the mouse leaves this widget.

Returns: bool Parent's result or TRUE if no parent.

Reimplemented from pawsWidget.

bool pawsControlWindow::PostSetup ( )

virtual

This is called after the widget and all of it's children have been created.

Remarks: This can be useful for widgets that want to get pointers to some of it's children for quick access.

Reimplemented from pawsWidget.

void pawsControlWindow::Register ( pawsControlledWindow * window )

When a new window registers make an entry for them in our list.

Parameters

window The window to register.

bool pawsControlWindow::setWindowPositionName	(	csString	widgetStr,
		int	x,
		int	y
	)

Used to set the position of windows from a command.

Parameters

widgetStr	The window to hide (command form, translated to the actual window name by the function)
x	New x postion ofthe window
y	New y postion ofthe window

Returns: FALSE in case of an error otherwise TRUE

bool pawsControlWindow::setWindowSizeName	(	csString	widgetStr,
		int	width,
		int	height
	)

Used to set the size of windows from a command.

Parameters

widgetStr	The window to resizehide (command form, translated to the actual window name by the function)
width	New width of the window
height	New height of the window

Returns: FALSE in case of an error otherwise TRUE

void pawsControlWindow::Show ( )

virtual

Makes widget visible and brings it to the front.

Sets visible TRUE shows border if present then calls BringToTop() on itself.

Reimplemented from pawsWidget.

bool pawsControlWindow::showWindow ( csString widgetStr )

Used to show a window.

If the window was already shown nothing happens.

Parameters

widgetStr The window to show

Returns: FALSE in case of an error otherwise TRUE

bool pawsControlWindow::showWindowName ( csString widgetStr )

Used to show a window from a command.

If the window was already shown nothing happens.

Parameters

widgetStr The window to hide (command form, translated to the actual window name by the function)

Returns: FALSE in case of an error otherwise TRUE

void pawsControlWindow::Toggle ( )

Toggle a window and it's children from hidden to visible or back depending on the window state when called.

void pawsControlWindow::WindowClose ( pawsWidget * wnd )

Changes the icon IsActive flag to FALSE and displays the proper background for it when a window is closed.

Parameters

wnd	The window that closed.

void pawsControlWindow::WindowOpen ( pawsWidget * wnd )

Changes the icon IsActive flag to TRUE and displays the proper background for it when a window is opened.

Parameters

wnd	The window that opened.

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

client/gui/pawscontrolwindow.h

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation