#include <kcommondecoration.h>

Inheritance diagram for KCommonDecoration:

Public Types
enum	LayoutMetric { LM_BorderLeft , LM_BorderRight , LM_BorderBottom , LM_TitleHeight , LM_TitleBorderLeft , LM_TitleBorderRight , LM_TitleEdgeLeft , LM_TitleEdgeRight , LM_TitleEdgeTop , LM_TitleEdgeBottom , LM_ButtonWidth , LM_ButtonHeight , LM_ButtonSpacing , LM_ExplicitButtonSpacer , LM_ButtonMarginTop , LM_RightButtonsMarginTop }
enum	DecorationBehaviour { DB_MenuClose , DB_WindowMask , DB_ButtonHide }
enum	WindowCorner { WC_TopLeft , WC_TopRight , WC_BottomLeft , WC_BottomRight }
Public Types inherited from KDecorationDefines
enum	Position { PositionCenter = 0x00 , PositionLeft = 0x01 , PositionRight = 0x02 , PositionTop = 0x04 , PositionBottom = 0x08 , PositionTopLeft = PositionLeft \| PositionTop , PositionTopRight = PositionRight \| PositionTop , PositionBottomLeft = PositionLeft \| PositionBottom , PositionBottomRight = PositionRight \| PositionBottom }
enum	MaximizeMode { MaximizeRestore = 0 , MaximizeVertical = 1 , MaximizeHorizontal = 2 , MaximizeFull = MaximizeVertical \| MaximizeHorizontal }
enum	WindowOperation { MaximizeOp = 5000 , RestoreOp , MinimizeOp , MoveOp , UnrestrictedMoveOp , ResizeOp , UnrestrictedResizeOp , CloseOp , OnAllDesktopsOp , ShadeOp , KeepAboveOp , KeepBelowOp , OperationsOp , WindowRulesOp , ToggleStoreSettingsOp = WindowRulesOp , HMaximizeOp , VMaximizeOp , LowerOp , FullScreenOp , NoBorderOp , NoOp , SetupWindowShortcutOp , ApplicationRulesOp , ShadowOp , SuspendWindowOp , ResumeWindowOp }
enum	ColorType { ColorTitleBar , ColorTitleBlend , ColorFont , ColorButtonBg , ColorFrame , ColorHandle , NUM_COLORS }
enum	{ SettingDecoration = 1 << 0 , SettingColors = 1 << 1 , SettingFont = 1 << 2 , SettingButtons = 1 << 3 , SettingTooltips = 1 << 4 , SettingBorder = 1 << 5 }
enum	BorderSize { BorderTiny , BorderNormal , BorderLarge , BorderVeryLarge , BorderHuge , BorderVeryHuge , BorderOversized , BordersCount }
enum	Ability { AbilityAnnounceButtons = 0 , AbilityButtonMenu = 1000 , AbilityButtonOnAllDesktops = 1001 , AbilityButtonSpacer = 1002 , AbilityButtonHelp = 1003 , AbilityButtonMinimize = 1004 , AbilityButtonMaximize = 1005 , AbilityButtonClose = 1006 , AbilityButtonAboveOthers = 1007 , AbilityButtonBelowOthers = 1008 , AbilityButtonShade = 1009 , AbilityButtonResize = 1010 , ABILITY_DUMMY = 10000000 }
enum	Requirement { REQUIREMENT_DUMMY = 1000000 }

Public Slots
void	keepAboveChange (bool above)
void	keepBelowChange (bool below)
void	slotMaximize ()
void	slotShade ()
void	slotKeepAbove ()
void	slotKeepBelow ()
void	menuButtonPressed ()
void	menuButtonReleased ()
Public Slots inherited from KDecoration
void	closeWindow ()
void	maximize (ButtonState button)
void	maximize (MaximizeMode mode)
void	minimize ()
void	showContextHelp ()
void	setDesktop (int desktop)
void	toggleOnAllDesktops ()
void	titlebarDblClickOperation ()
void	titlebarMouseWheelOperation (int delta)
void	setShade (bool set)
void	setKeepAbove (bool set)
void	setKeepBelow (bool set)
void	emitKeepAboveChanged (bool above)
void	emitKeepBelowChanged (bool below)

Public Member Functions
	KCommonDecoration (KDecorationBridge bridge, KDecorationFactory factory)
virtual TQString	visibleName () const =0
virtual TQString	defaultButtonsLeft () const =0
virtual TQString	defaultButtonsRight () const =0
virtual bool	decorationBehaviour (DecorationBehaviour behaviour) const
virtual int	layoutMetric (LayoutMetric lm, bool respectWindowState=true, const KCommonDecorationButton *button=0) const
virtual KCommonDecorationButton *	createButton (ButtonType type)=0
virtual TQRegion	cornerShape (WindowCorner corner)
virtual void	updateWindowShape ()
virtual void	paintEvent (TQPaintEvent *e)=0
virtual void	updateCaption ()
int	buttonsLeftWidth () const
int	buttonsRightWidth () const
void	updateLayout () const
void	updateButtons () const
void	resetButtons () const
bool	isToolWindow () const
TQRect	titleRect () const
virtual void	init ()
virtual void	reset (unsigned long changed)
virtual void	borders (int &left, int &right, int &top, int &bottom) const
virtual void	show ()
virtual void	resize (const TQSize &s)
virtual TQSize	minimumSize () const
virtual void	maximizeChange ()
virtual void	desktopChange ()
virtual void	shadeChange ()
virtual void	iconChange ()
virtual void	activeChange ()
virtual void	captionChange ()
virtual Position	mousePosition (const TQPoint &point) const
virtual bool	eventFilter (TQObject o, TQEvent e)
virtual void	resizeEvent (TQResizeEvent *e)
virtual void	mouseDoubleClickEvent (TQMouseEvent *e)
virtual void	wheelEvent (TQWheelEvent *e)
Public Member Functions inherited from KDecoration
	KDecoration (KDecorationBridge bridge, KDecorationFactory factory)
virtual	~KDecoration ()
bool	isActive () const
bool	isCloseable () const
bool	isMaximizable () const
MaximizeMode	maximizeMode () const
bool	isMinimizable () const
bool	providesContextHelp () const
int	desktop () const
bool	isOnAllDesktops () const
bool	isModal () const
bool	isShadeable () const
bool	isShade () const
bool	isSetShade () const
bool	keepAbove () const
bool	keepBelow () const
bool	isMovable () const
bool	isResizable () const
NET::WindowType	windowType (unsigned long supported_types) const
TQIconSet	icon () const
TQString	caption () const
void	showWindowMenu (const TQRect &pos)
void	showWindowMenu (TQPoint pos)
void	performWindowOperation (WindowOperation op)
void	setMask (const TQRegion &reg, int mode=0)
void	clearMask ()
bool	isPreview () const
TQRect	geometry () const
TQRect	iconGeometry () const
TQRegion	unobscuredRegion (const TQRegion &r) const
TQWidget *	workspaceWidget () const
WId	windowId () const
int	width () const
int	height () const
void	processMousePressEvent (TQMouseEvent *e)
virtual bool	drawbound (const TQRect &geom, bool clear)
virtual bool	animateMinimize (bool minimize)
virtual bool	windowDocked (Position side)
void	setMainWidget (TQWidget *)
void	createMainWidget (TQt::WFlags flags=0)
TQWidget *	initialParentWidget () const
TQt::WFlags	initialWFlags () const
void	helperShowHide (bool show)
TQWidget *	widget ()
const TQWidget *	widget () const
KDecorationFactory *	factory () const
void	grabXServer ()
void	ungrabXServer ()

Additional Inherited Members
Signals inherited from KDecoration
void	keepAboveChanged (bool)
void	keepBelowChanged (bool)
Static Public Member Functions inherited from KDecoration
static const KDecorationOptions *	options ()

Detailed Description

This class eases development of decorations by implementing parts of KDecoration which are error prone and common for most decorations.

It takes care of the window layout, button/action handling, and window mask creation.

Definition at line 59 of file kcommondecoration.h.

Member Enumeration Documentation

◆ DecorationBehaviour

enum KCommonDecoration::DecorationBehaviour

Enumerator
DB_MenuClose	Close window on double clicking the menu.
DB_WindowMask	Set a mask on the window.
DB_ButtonHide	Hide buttons when there is not enough space in the titlebar.

Definition at line 120 of file kcommondecoration.h.

◆ LayoutMetric

enum KCommonDecoration::LayoutMetric

Used to calculate the decoration layout.

The basic layout looks like this:

Window:

| LM_TitleEdgeTop | |_______________________________________________________________| | LM_TitleEdgeLeft | [title] | LM_TitleEdgeRight | |__________________|________________________|___________________| | LM_TitleEdgeBottom | |_______________________________________________________________|

|LM_BorderLeft LM_BorderRight| |_|___________________________________________________________|_| | LM_BorderBottom | |_______________________________________________________________|

Title:

| LM_ButtonMarginTop | | LM_ButtonMarginTop | |________________________________| |_________________________________| | [Buttons] | LM_TitleBorderLeft | LM_TitleHeight | LM_TitleBorderRight | [Buttons] | |___________|____________________|________________|_____________________|___________|

Buttons:

| button | spacing | button | spacing | explicit spacer | spacing | ... | spacing | button | |________|_________|________|_________|_________________|_________|________|_________|________|

See also: layoutMetric()

Definition at line 100 of file kcommondecoration.h.

◆ WindowCorner

enum KCommonDecoration::WindowCorner

Definition at line 127 of file kcommondecoration.h.

Constructor & Destructor Documentation

◆ KCommonDecoration()

KCommonDecoration::KCommonDecoration	(	KDecorationBridge *	bridge,
		KDecorationFactory *	factory )

Definition at line 46 of file kcommondecoration.cpp.

◆ ~KCommonDecoration()

KCommonDecoration::~KCommonDecoration ( )

virtual

Definition at line 57 of file kcommondecoration.cpp.

Member Function Documentation

◆ activeChange()

void KCommonDecoration::activeChange ( )

virtual

This function is called whenever the window either becomes or stops being active.

Use isActive() to find out the current state.

Implements KDecoration.

Definition at line 583 of file kcommondecoration.cpp.

◆ borders()

void KCommonDecoration::borders	(	int &	left,
		int &	right,
		int &	top,
		int &	bottom ) const

virtual

This function should return the distance from each window side to the inner window.

The sizes may depend on the state of the decorated window, such as whether it's shaded. Decorations often turn off their bottom border when the window is shaded, and turn off their left/right/bottom borders when the window is maximized and moving and resizing of maximized windows is disabled. This function mustn't do any repaints or resizes. Also, if the sizes returned by this function don't match the real values, this may result in drawing errors or other problems.

See also: KDecorationOptions::moveResizeMaximizedWindows()

Implements KDecoration.

Definition at line 152 of file kcommondecoration.cpp.

◆ buttonsLeftWidth()

int KCommonDecoration::buttonsLeftWidth ( ) const

Definition at line 293 of file kcommondecoration.cpp.

◆ buttonsRightWidth()

int KCommonDecoration::buttonsRightWidth ( ) const

Definition at line 298 of file kcommondecoration.cpp.

◆ captionChange()

void KCommonDecoration::captionChange ( )

virtual

This function is called whenever the caption changes.

Use caption() to get it.

Implements KDecoration.

Definition at line 589 of file kcommondecoration.cpp.

◆ cornerShape()

TQRegion KCommonDecoration::cornerShape ( WindowCorner corner )

virtual

Returns: the mask for the specific window corner.

Definition at line 141 of file kcommondecoration.cpp.

◆ createButton()

virtual KCommonDecorationButton * KCommonDecoration::createButton ( ButtonType type )

pure virtual

Create a new title bar button.

KCommonDecoration takes care of memory management.

Returns: a pointer to the button, or 0 if the button should not be created.

◆ decorationBehaviour()

bool KCommonDecoration::decorationBehaviour ( DecorationBehaviour behaviour ) const

virtual

This controls whether some specific behaviour should be enabled or not.

See also: DecorationBehaviour

Definition at line 65 of file kcommondecoration.cpp.

◆ defaultButtonsLeft()

virtual TQString KCommonDecoration::defaultButtonsLeft ( ) const

pure virtual

The default title button order on the left.

See also: KDecoration::titleButtonsLeft(); KDecoration::titleButtonsRight()

◆ defaultButtonsRight()

virtual TQString KCommonDecoration::defaultButtonsRight ( ) const

pure virtual

The default title button order on the left.

See also: KDecoration::titleButtonsLeft(); KDecoration::titleButtonsRight()

◆ desktopChange()

void KCommonDecoration::desktopChange ( )

virtual

This function is called whenever the desktop for the window changes.

Use desktop() or isOnAllDesktops() to find out the current desktop on which the window is.

Implements KDecoration.

Definition at line 551 of file kcommondecoration.cpp.

◆ eventFilter()

bool KCommonDecoration::eventFilter	(	TQObject *	o,
		TQEvent *	e )

virtual

Definition at line 861 of file kcommondecoration.cpp.

◆ iconChange()

void KCommonDecoration::iconChange ( )

virtual

This function is called whenever the window icon changes.

Use icon() to get it.

Implements KDecoration.

Definition at line 574 of file kcommondecoration.cpp.

◆ init()

void KCommonDecoration::init ( )

virtual

Handles widget and layout creation, call the base implementation when subclassing this member.

Implements KDecoration.

Definition at line 116 of file kcommondecoration.cpp.

◆ isToolWindow()

bool KCommonDecoration::isToolWindow ( ) const

Convenience method.

Returns: true if the window type is NET::Toolbar, NET::Utility, or NET::Menu

Definition at line 891 of file kcommondecoration.cpp.

◆ keepAboveChange

void KCommonDecoration::keepAboveChange ( bool above )

slot

Definition at line 594 of file kcommondecoration.cpp.

◆ keepBelowChange

void KCommonDecoration::keepBelowChange ( bool below )

slot

Definition at line 611 of file kcommondecoration.cpp.

◆ layoutMetric()

int KCommonDecoration::layoutMetric	(	LayoutMetric	lm,
		bool	respectWindowState = true,
		const KCommonDecorationButton *	button = 0 ) const

virtual

This controls the layout of the decoration in various ways.

It is possible to have a different layout for different window states.

Parameters

lm	The layout element.
respectWindowState	Whether window states should be taken into account or a "default" state should be assumed.
button	For LM_ButtonWidth and LM_ButtonHeight, the button.

Definition at line 81 of file kcommondecoration.cpp.

◆ maximizeChange()

void KCommonDecoration::maximizeChange ( )

virtual

This function is called whenever the maximalization state of the window changes.

Use maximizeMode() to get the current state.

Implements KDecoration.

Definition at line 538 of file kcommondecoration.cpp.

◆ menuButtonPressed

void KCommonDecoration::menuButtonPressed ( )

slot

Definition at line 651 of file kcommondecoration.cpp.

◆ menuButtonReleased

void KCommonDecoration::menuButtonReleased ( )

slot

Definition at line 674 of file kcommondecoration.cpp.

◆ minimumSize()

TQSize KCommonDecoration::minimumSize ( ) const

virtual

This function should return the minimum required size for the decoration.

Note that the returned size shouldn't be too large, because it will be used to keep the decorated window at least as large.

Implements KDecoration.

Definition at line 527 of file kcommondecoration.cpp.

◆ mouseDoubleClickEvent()

void KCommonDecoration::mouseDoubleClickEvent ( TQMouseEvent * e )

virtual

Definition at line 713 of file kcommondecoration.cpp.

◆ mousePosition()

KCommonDecoration::Position KCommonDecoration::mousePosition ( const TQPoint & p ) const

virtual

This function should return mouse cursor position in the decoration.

Positions at the edge will result in window resizing with mouse button pressed, center position will result in moving.

Implements KDecoration.

Definition at line 732 of file kcommondecoration.cpp.

◆ paintEvent()

virtual void KCommonDecoration::paintEvent ( TQPaintEvent * e )

pure virtual

Draw the window decoration.

◆ reset()

void KCommonDecoration::reset ( unsigned long changed )

virtual

Handles SettingButtons, call the base implementation when subclassing this member.

Reimplemented from KDecoration.

Definition at line 133 of file kcommondecoration.cpp.

◆ resetButtons()

void KCommonDecoration::resetButtons ( ) const

Manually call reset() on each button.

Definition at line 250 of file kcommondecoration.cpp.

◆ resize()

void KCommonDecoration::resize ( const TQSize & s )

virtual

This method is called by twin when the style should resize the decoration window.

The usual implementation is to resize the main widget of the decoration to the given size.

Parameters

s	Specifies the new size of the decoration window.

Implements KDecoration.

Definition at line 522 of file kcommondecoration.cpp.

◆ resizeEvent()

void KCommonDecoration::resizeEvent ( TQResizeEvent * e )

virtual

Definition at line 680 of file kcommondecoration.cpp.

◆ shadeChange()

void KCommonDecoration::shadeChange ( )

virtual

This function is called whenever the window is shaded or unshaded.

Use isShade() to get the current state.

Implements KDecoration.

Definition at line 562 of file kcommondecoration.cpp.

◆ show()

void KCommonDecoration::show ( )

virtual

Definition at line 515 of file kcommondecoration.cpp.

◆ slotKeepAbove

void KCommonDecoration::slotKeepAbove ( )

slot

Definition at line 641 of file kcommondecoration.cpp.

◆ slotKeepBelow

void KCommonDecoration::slotKeepBelow ( )

slot

Definition at line 646 of file kcommondecoration.cpp.

◆ slotMaximize

void KCommonDecoration::slotMaximize ( )

slot

Definition at line 628 of file kcommondecoration.cpp.

◆ slotShade

void KCommonDecoration::slotShade ( )

slot

Definition at line 636 of file kcommondecoration.cpp.

◆ titleRect()

TQRect KCommonDecoration::titleRect ( ) const

Convenience method.

Returns: the title rect.

Definition at line 897 of file kcommondecoration.cpp.

◆ updateButtons()

void KCommonDecoration::updateButtons ( ) const

Makes sure all buttons are repainted.

Definition at line 244 of file kcommondecoration.cpp.

◆ updateCaption()

void KCommonDecoration::updateCaption ( )

virtual

This is used to update the painting of the title bar after the caption has been changed.

Reimplement for a more efficient implementation (default calls update() on the whole decoration).

Definition at line 146 of file kcommondecoration.cpp.

◆ updateLayout()

void KCommonDecoration::updateLayout ( ) const

TODO: remove?

Definition at line 164 of file kcommondecoration.cpp.

◆ updateWindowShape()

void KCommonDecoration::updateWindowShape ( )

virtual

This updates the window mask using the information provided by cornerShape().

Edges which are aligned to screen corners are not shaped for better usability (remember to paint these areas in paintEvent(), too). You normally don't want/need to reimplement updateWindowShape().

See also: cornerShape()

Definition at line 811 of file kcommondecoration.cpp.

◆ visibleName()

virtual TQString KCommonDecoration::visibleName ( ) const

pure virtual

The name of the decoration used in the decoration preview.

◆ wheelEvent()

void KCommonDecoration::wheelEvent ( TQWheelEvent * e )

virtual

Definition at line 725 of file kcommondecoration.cpp.

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

twin/lib

Public Types

Public Slots

Public Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ DecorationBehaviour

◆ LayoutMetric

◆ WindowCorner

Constructor & Destructor Documentation

◆ KCommonDecoration()

◆ ~KCommonDecoration()

Member Function Documentation

◆ activeChange()

◆ borders()

◆ buttonsLeftWidth()

◆ buttonsRightWidth()

◆ captionChange()

◆ cornerShape()

◆ createButton()

◆ decorationBehaviour()

◆ defaultButtonsLeft()

◆ defaultButtonsRight()

◆ desktopChange()

◆ eventFilter()

◆ iconChange()

◆ init()

◆ isToolWindow()

◆ keepAboveChange

◆ keepBelowChange

◆ layoutMetric()

◆ maximizeChange()

◆ menuButtonPressed

◆ menuButtonReleased

◆ minimumSize()

◆ mouseDoubleClickEvent()

◆ mousePosition()

◆ paintEvent()

◆ reset()

◆ resetButtons()

◆ resize()

◆ resizeEvent()

◆ shadeChange()

◆ show()

◆ slotKeepAbove

◆ slotKeepBelow

◆ slotMaximize

◆ slotShade

◆ titleRect()

◆ updateButtons()

◆ updateCaption()

◆ updateLayout()

◆ updateWindowShape()

◆ visibleName()

◆ wheelEvent()

twin/lib

twin/lib