A base class for top-level windows that can be dragged around and resized. More...

Inherited by DocumentWindow, and FileChooserDialogBox.

Public Types
enum	ColourIds { backgroundColourId = 0x1005700 }
	A set of colour IDs to use to change the colour of various aspects of the window. More...
Public Member Functions
	ResizableWindow (const String &name, bool addToDesktop)
	Creates a ResizableWindow.
	ResizableWindow (const String &name, const Colour &backgroundColour, bool addToDesktop)
	Creates a ResizableWindow.
	~ResizableWindow ()
	Destructor.
Colour	getBackgroundColour () const noexcept
	Returns the colour currently being used for the window's background.
void	setBackgroundColour (const Colour &newColour)
	Changes the colour currently being used for the window's background.
void	setResizable (bool shouldBeResizable, bool useBottomRightCornerResizer)
	Make the window resizable or fixed.
bool	isResizable () const noexcept
	True if resizing is enabled.
void	setResizeLimits (int newMinimumWidth, int newMinimumHeight, int newMaximumWidth, int newMaximumHeight) noexcept
	This sets the maximum and minimum sizes for the window.
ComponentBoundsConstrainer *	getConstrainer () noexcept
	Returns the bounds constrainer object that this window is using.
void	setConstrainer (ComponentBoundsConstrainer *newConstrainer)
	Sets the bounds-constrainer object to use for resizing and dragging this window.
void	setBoundsConstrained (const Rectangle< int > &bounds)
	Calls the window's setBounds method, after first checking these bounds with the current constrainer.
bool	isFullScreen () const
	Returns true if the window is currently in full-screen mode.
void	setFullScreen (bool shouldBeFullScreen)
	Puts the window into full-screen mode, or restores it to its normal size.
bool	isMinimised () const
	Returns true if the window is currently minimised.
void	setMinimised (bool shouldMinimise)
	Minimises the window, or restores it to its previous position and size.
void	addToDesktop ()
	Adds the window to the desktop using the default flags.
String	getWindowStateAsString ()
	Returns a string which encodes the window's current size and position.
bool	restoreWindowStateFromString (const String &previousState)
	Restores the window to a previously-saved size and position.
Component *	getContentComponent () const noexcept
	Returns the current content component.
void	setContentOwned (Component *newContentComponent, bool resizeToFitWhenContentChangesSize)
	Changes the current content component.
void	setContentNonOwned (Component *newContentComponent, bool resizeToFitWhenContentChangesSize)
	Changes the current content component.
void	clearContentComponent ()
	Removes the current content component.
void	setContentComponentSize (int width, int height)
	Changes the window so that the content component ends up with the specified size.
virtual BorderSize< int >	getBorderThickness ()
	Returns the width of the frame to use around the window.
virtual BorderSize< int >	getContentComponentBorder ()
	Returns the insets to use when positioning the content component.
	JUCE_DEPRECATED (void setContentComponent(Component *newContentComponent, bool deleteOldOne=true, bool resizeToFit=false))
Protected Member Functions
void	paint (Graphics &g)
void	moved ()
	(if overriding this, make sure you call ResizableWindow::moved() in your subclass)
void	resized ()
	(if overriding this, make sure you call ResizableWindow::resized() in your subclass)
void	mouseDown (const MouseEvent &e)
void	mouseDrag (const MouseEvent &e)
void	lookAndFeelChanged ()
void	childBoundsChanged (Component *child)
void	parentSizeChanged ()
void	visibilityChanged ()
void	activeWindowStatusChanged ()
int	getDesktopWindowStyleFlags () const
Protected Attributes
ScopedPointer < ResizableCornerComponent >	resizableCorner
ScopedPointer < ResizableBorderComponent >	resizableBorder

Detailed Description

A base class for top-level windows that can be dragged around and resized.

To add content to the window, use its setContentOwned() or setContentNonOwned() methods to give it a component that will remain positioned inside it (leaving a gap around the edges for a border).

It's not advisable to add child components directly to a ResizableWindow: put them inside your content component instead. And overriding methods like resized(), moved(), etc is also not recommended - instead override these methods for your content component. (If for some obscure reason you do need to override these methods, always remember to call the super-class's resized() method too, otherwise it'll fail to lay out the window decorations correctly).

By default resizing isn't enabled - use the setResizable() method to enable it and to choose the style of resizing to use.

See also:: TopLevelWindow

Member Enumeration Documentation

enum ResizableWindow::ColourIds

A set of colour IDs to use to change the colour of various aspects of the window.

These constants can be used either via the Component::setColour(), or LookAndFeel::setColour() methods.

See also:: Component::setColour, Component::findColour, LookAndFeel::setColour, LookAndFeel::findColour

Enumerator:

backgroundColourId

A colour to use to fill the window's background.

Reimplemented in DocumentWindow, and FileChooserDialogBox.

Constructor & Destructor Documentation

ResizableWindow::ResizableWindow	(	const String &	name,
		bool	addToDesktop
	)

Creates a ResizableWindow.

This constructor doesn't specify a background colour, so the LookAndFeel's default background colour will be used.

Parameters:

name	the name to give the component
addToDesktop	if true, the window will be automatically added to the desktop; if false, you can use it as a child component

ResizableWindow::ResizableWindow	(	const String &	name,
		const Colour &	backgroundColour,
		bool	addToDesktop
	)

Creates a ResizableWindow.

Parameters:

name	the name to give the component
backgroundColour	the colour to use for filling the window's background.
addToDesktop	if true, the window will be automatically added to the desktop; if false, you can use it as a child component

ResizableWindow::~ResizableWindow ( )

Destructor.

If a content component has been set with setContentOwned(), it will be deleted.

Member Function Documentation

Colour ResizableWindow::getBackgroundColour ( ) const

Returns the colour currently being used for the window's background.

As a convenience the window will fill itself with this colour, but you can override the paint() method if you need more customised behaviour.

This method is the same as retrieving the colour for ResizableWindow::backgroundColourId.

See also:: setBackgroundColour

void ResizableWindow::setBackgroundColour ( const Colour & newColour )

Changes the colour currently being used for the window's background.

As a convenience the window will fill itself with this colour, but you can override the paint() method if you need more customised behaviour.

Note that the opaque state of this window is altered by this call to reflect the opacity of the colour passed-in. On window systems which can't support semi-transparent windows this might cause problems, (though it's unlikely you'll be using this class as a base for a semi-transparent component anyway).

You can also use the ResizableWindow::backgroundColourId colour id to set this colour.

See also:: getBackgroundColour

void ResizableWindow::setResizable	(	bool	shouldBeResizable,
		bool	useBottomRightCornerResizer
	)

Make the window resizable or fixed.

Parameters:

shouldBeResizable	whether it's resizable at all
useBottomRightCornerResizer	if true, it'll add a ResizableCornerComponent at the bottom-right; if false, it'll use a ResizableBorderComponent around the edge

See also:: setResizeLimits, isResizable

bool ResizableWindow::isResizable ( ) const

True if resizing is enabled.

See also:: setResizable

void ResizableWindow::setResizeLimits	(	int	newMinimumWidth,
		int	newMinimumHeight,
		int	newMaximumWidth,
		int	newMaximumHeight
	)

This sets the maximum and minimum sizes for the window.

If the window's current size is outside these limits, it will be resized to make sure it's within them.

Calling setBounds() on the component will bypass any size checking - it's only when the window is being resized by the user that these values are enforced.

See also:: setResizable, setFixedAspectRatio

ComponentBoundsConstrainer* ResizableWindow::getConstrainer ( )

Returns the bounds constrainer object that this window is using.

You can access this to change its properties.

void ResizableWindow::setConstrainer ( ComponentBoundsConstrainer * newConstrainer )

Sets the bounds-constrainer object to use for resizing and dragging this window.

A pointer to the object you pass in will be kept, but it won't be deleted by this object, so it's the caller's responsiblity to manage it.

If you pass 0, then no contraints will be placed on the positioning of the window.

void ResizableWindow::setBoundsConstrained ( const Rectangle< int > & bounds )

Calls the window's setBounds method, after first checking these bounds with the current constrainer.

See also:: setConstrainer

Referenced by StandaloneFilterWindow::StandaloneFilterWindow().

bool ResizableWindow::isFullScreen ( ) const

Returns true if the window is currently in full-screen mode.

See also:: setFullScreen

void ResizableWindow::setFullScreen ( bool shouldBeFullScreen )

Puts the window into full-screen mode, or restores it to its normal size.

If true, the window will become full-screen; if false, it will return to the last size it was before being made full-screen.

See also:: isFullScreen

bool ResizableWindow::isMinimised ( ) const

Returns true if the window is currently minimised.

See also:: setMinimised

void ResizableWindow::setMinimised ( bool shouldMinimise )

Minimises the window, or restores it to its previous position and size.

When being un-minimised, it'll return to the last position and size it was in before being minimised.

See also:: isMinimised

void ResizableWindow::addToDesktop ( )

Adds the window to the desktop using the default flags.

String ResizableWindow::getWindowStateAsString ( )

Returns a string which encodes the window's current size and position.

This string will encapsulate the window's size, position, and whether it's in full-screen mode. It's intended for letting your application save and restore a window's position.

Use the restoreWindowStateFromString() to restore from a saved state.

See also:: restoreWindowStateFromString

bool ResizableWindow::restoreWindowStateFromString ( const String & previousState )

Restores the window to a previously-saved size and position.

This restores the window's size, positon and full-screen status from an string that was previously created with the getWindowStateAsString() method.

Returns:: false if the string wasn't a valid window state

See also:: getWindowStateAsString

Component* ResizableWindow::getContentComponent ( ) const

Returns the current content component.

This will be the component set by setContentOwned() or setContentNonOwned, or 0 if none has yet been specified.

See also:: setContentOwned, setContentNonOwned

void ResizableWindow::setContentOwned	(	Component *	newContentComponent,
		bool	resizeToFitWhenContentChangesSize
	)

Changes the current content component.

This sets a component that will be placed in the centre of the ResizableWindow, (leaving a space around the edge for the border).

You should never add components directly to a ResizableWindow (or any of its subclasses) with addChildComponent(). Instead, add them to the content component.

Parameters:

newContentComponent	the new component to use - this component will be deleted when it's no longer needed (i.e. when the window is deleted or a new content component is set for it). To set a component that this window will not delete, call setContentNonOwned() instead.
resizeToFitWhenContentChangesSize	if true, then the ResizableWindow will maintain its size such that it always fits around the size of the content component. If false, the new content will be resized to fit the current space available.

Referenced by StandaloneFilterWindow::resetFilter(), and StandaloneFilterWindow::StandaloneFilterWindow().

void ResizableWindow::setContentNonOwned	(	Component *	newContentComponent,
		bool	resizeToFitWhenContentChangesSize
	)

Changes the current content component.

This sets a component that will be placed in the centre of the ResizableWindow, (leaving a space around the edge for the border).

You should never add components directly to a ResizableWindow (or any of its subclasses) with addChildComponent(). Instead, add them to the content component.

Parameters:

newContentComponent	the new component to use - this component will NOT be deleted by this component, so it's the caller's responsibility to manage its lifetime (it's ok to delete it while this window is still using it). To set a content component that the window will delete, call setContentOwned() instead.
resizeToFitWhenContentChangesSize	if true, then the ResizableWindow will maintain its size such that it always fits around the size of the content component. If false, the new content will be resized to fit the current space available.

void ResizableWindow::clearContentComponent ( )

Removes the current content component.

If the previous content component was added with setContentOwned(), it will also be deleted. If it was added with setContentNonOwned(), it will simply be removed from this component.

void ResizableWindow::setContentComponentSize	(	int	width,
		int	height
	)

Changes the window so that the content component ends up with the specified size.

This is basically a setSize call on the window, but which adds on the borders, so you can specify the content component's target size.

virtual BorderSize<int> ResizableWindow::getBorderThickness ( ) [virtual]

Returns the width of the frame to use around the window.

See also:: getContentComponentBorder

virtual BorderSize<int> ResizableWindow::getContentComponentBorder ( ) [virtual]

Returns the insets to use when positioning the content component.

See also:: getBorderThickness

ResizableWindow::JUCE_DEPRECATED ( void setContentComponentComponent *newContentComponent, bool deleteOldOne=true, bool resizeToFit=false )

Deprecated:

use setContentOwned() and setContentNonOwned() instead.

void ResizableWindow::paint ( Graphics & g ) [protected, virtual]

Reimplemented from Component.

void ResizableWindow::moved ( ) [protected, virtual]

(if overriding this, make sure you call ResizableWindow::moved() in your subclass)

Reimplemented from Component.

void ResizableWindow::resized ( ) [protected, virtual]

(if overriding this, make sure you call ResizableWindow::resized() in your subclass)

Reimplemented from Component.

Reimplemented in StandaloneFilterWindow, and DialogWindow.

void ResizableWindow::mouseDown ( const MouseEvent & e ) [protected, virtual]

Reimplemented from Component.

void ResizableWindow::mouseDrag ( const MouseEvent & e ) [protected, virtual]

Reimplemented from Component.

void ResizableWindow::lookAndFeelChanged ( ) [protected, virtual]

Reimplemented from Component.

void ResizableWindow::childBoundsChanged ( Component * child ) [protected, virtual]

Reimplemented from Component.

void ResizableWindow::parentSizeChanged ( ) [protected, virtual]

Reimplemented from Component.

void ResizableWindow::visibilityChanged ( ) [protected, virtual]

Reimplemented from TopLevelWindow.

void ResizableWindow::activeWindowStatusChanged ( ) [protected, virtual]

Reimplemented from TopLevelWindow.

Reimplemented in MultiDocumentPanelWindow.

int ResizableWindow::getDesktopWindowStyleFlags ( ) const [protected, virtual]

Reimplemented from TopLevelWindow.

Member Data Documentation

ScopedPointer<ResizableCornerComponent> ResizableWindow::resizableCorner [protected]

ScopedPointer<ResizableBorderComponent> ResizableWindow::resizableBorder [protected]

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

juce_ResizableWindow.h

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation