The Component class uses a ComponentPeer internally to create and manage a real operating-system window. More...

Classes
struct	DragInfo

Public Types
enum	StyleFlags { windowAppearsOnTaskbar = (1 << 0), windowIsTemporary = (1 << 1), windowIgnoresMouseClicks = (1 << 2), windowHasTitleBar = (1 << 3), windowIsResizable = (1 << 4), windowHasMinimiseButton = (1 << 5), windowHasMaximiseButton = (1 << 6), windowHasCloseButton = (1 << 7), windowHasDropShadow = (1 << 8), windowRepaintedExplictly = (1 << 9), windowIgnoresKeyPresses = (1 << 10), windowIsSemiTransparent = (1 << 31) }
	A combination of these flags is passed to the ComponentPeer constructor. More...

Public Member Functions
	ComponentPeer (Component &component, int styleFlags)
	Creates a peer. More...

virtual	~ComponentPeer ()
	Destructor. More...

Component &	getComponent () noexcept
	Returns the component being represented by this peer. More...

int	getStyleFlags () const noexcept
	Returns the set of style flags that were set when the window was created. More...

uint32	getUniqueID () const noexcept
	Returns a unique ID for this peer. More...

virtual void *	getNativeHandle () const =0
	Returns the raw handle to whatever kind of window is being used. More...

virtual void	setVisible (bool shouldBeVisible)=0
	Shows or hides the window. More...

virtual void	setTitle (const String &title)=0
	Changes the title of the window. More...

virtual bool	setDocumentEditedStatus (bool edited)
	If this type of window is capable of indicating that the document in it has been edited, then this changes its status. More...

virtual void	setRepresentedFile (const File &)
	If this type of window is capable of indicating that it represents a file, then this lets you set the file. More...

virtual void	setBounds (const Rectangle< int > &newBounds, bool isNowFullScreen)=0
	Moves and resizes the window. More...

void	updateBounds ()
	Updates the peer's bounds to match its component. More...

virtual Rectangle< int >	getBounds () const =0
	Returns the current position and size of the window. More...

virtual Point< float >	localToGlobal (Point< float > relativePosition)=0
	Converts a position relative to the top-left of this component to screen coordinates. More...

virtual Point< float >	globalToLocal (Point< float > screenPosition)=0
	Converts a screen coordinate to a position relative to the top-left of this component. More...

Point< int >	localToGlobal (Point< int > relativePosition)
	Converts a position relative to the top-left of this component to screen coordinates. More...

Point< int >	globalToLocal (Point< int > screenPosition)
	Converts a screen coordinate to a position relative to the top-left of this component. More...

virtual Rectangle< int >	localToGlobal (const Rectangle< int > &relativePosition)
	Converts a rectangle relative to the top-left of this component to screen coordinates. More...

virtual Rectangle< int >	globalToLocal (const Rectangle< int > &screenPosition)
	Converts a screen area to a position relative to the top-left of this component. More...

Rectangle< int >	getAreaCoveredBy (Component &subComponent) const
	Returns the area in peer coordinates that is covered by the given sub-comp (which may be at any depth) More...

virtual void	setMinimised (bool shouldBeMinimised)=0
	Minimises the window. More...

virtual bool	isMinimised () const =0
	True if the window is currently minimised. More...

virtual void	setFullScreen (bool shouldBeFullScreen)=0
	Enable/disable fullscreen mode for the window. More...

virtual bool	isFullScreen () const =0
	True if the window is currently full-screen. More...

virtual bool	isKioskMode () const
	True if the window is in kiosk-mode. More...

void	setNonFullScreenBounds (const Rectangle< int > &newBounds) noexcept
	Sets the size to restore to if fullscreen mode is turned off. More...

const Rectangle< int > &	getNonFullScreenBounds () const noexcept
	Returns the size to restore to if fullscreen mode is turned off. More...

virtual void	setIcon (const Image &newIcon)=0
	Attempts to change the icon associated with this window. More...

void	setConstrainer (ComponentBoundsConstrainer *newConstrainer) noexcept
	Sets a constrainer to use if the peer can resize itself. More...

ComponentBoundsConstrainer *	getConstrainer () const noexcept
	Returns the current constrainer, if one has been set. More...

virtual bool	contains (Point< int > localPos, bool trueIfInAChildWindow) const =0
	Checks if a point is in the window. More...

virtual BorderSize< int >	getFrameSize () const =0
	Returns the size of the window frame that's around this window. More...

void	handleMovedOrResized ()
	This is called when the window's bounds change. More...

virtual void	handleScreenSizeChange ()
	This is called if the screen resolution changes. More...

void	handlePaint (LowLevelGraphicsContext &contextToPaintTo)
	This is called to repaint the component into the given context. More...

virtual bool	setAlwaysOnTop (bool alwaysOnTop)=0
	Sets this window to either be always-on-top or normal. More...

virtual void	toFront (bool makeActive)=0
	Brings the window to the top, optionally also giving it focus. More...

virtual void	toBehind (ComponentPeer *other)=0
	Moves the window to be just behind another one. More...

void	handleBroughtToFront ()
	Called when the window is brought to the front, either by the OS or by a call to toFront(). More...

virtual bool	isFocused () const =0
	True if the window has the keyboard focus. More...

virtual void	grabFocus ()=0
	Tries to give the window keyboard focus. More...

void	handleFocusGain ()
	Called when the window gains keyboard focus. More...

void	handleFocusLoss ()
	Called when the window loses keyboard focus. More...

Component *	getLastFocusedSubcomponent () const noexcept

bool	handleKeyPress (int keyCode, juce_wchar textCharacter)
	Called when a key is pressed. More...

bool	handleKeyPress (const KeyPress &key)
	Called when a key is pressed. More...

bool	handleKeyUpOrDown (bool isKeyDown)
	Called whenever a key is pressed or released. More...

void	handleModifierKeysChange ()
	Called whenever a modifier key is pressed or released. More...

virtual void	textInputRequired (Point< int > position, TextInputTarget &)=0
	Tells the window that text input may be required at the given position. More...

virtual void	dismissPendingTextInput ()
	If there's some kind of OS input-method in progress, this should dismiss it. More...

TextInputTarget *	findCurrentTextInputTarget ()
	Returns the currently focused TextInputTarget, or null if none is found. More...

virtual void	repaint (const Rectangle< int > &area)=0
	Invalidates a region of the window to be repainted asynchronously. More...

virtual void	performAnyPendingRepaintsNow ()=0
	This can be called (from the message thread) to cause the immediate redrawing of any areas of this window that need repainting. More...

virtual void	setAlpha (float newAlpha)=0
	Changes the window's transparency. More...

void	handleMouseEvent (int touchIndex, Point< float > positionWithinPeer, ModifierKeys newMods, float pressure, int64 time)

void	handleMouseWheel (int touchIndex, Point< float > positionWithinPeer, int64 time, const MouseWheelDetails &)

void	handleMagnifyGesture (int touchIndex, Point< float > positionWithinPeer, int64 time, float scaleFactor)

void	handleUserClosingWindow ()

bool	handleDragMove (const DragInfo &)

bool	handleDragExit (const DragInfo &)

bool	handleDragDrop (const DragInfo &)

virtual StringArray	getAvailableRenderingEngines ()=0

virtual int	getCurrentRenderingEngine () const

virtual void	setCurrentRenderingEngine (int index)

Static Public Member Functions
static int	getNumPeers () noexcept
	Returns the number of currently-active peers. More...

static ComponentPeer *	getPeer (int index) noexcept
	Returns one of the currently-active peers. More...

static ComponentPeer *	getPeerFor (const Component *) noexcept
	Returns the peer that's attached to the given component, or nullptr if there isn't one. More...

static bool	isValidPeer (const ComponentPeer *peer) noexcept
	Checks if this peer object is valid. More...

Protected Attributes
Component &	component

const int	styleFlags

Rectangle< int >	lastNonFullscreenBounds

ComponentBoundsConstrainer *	constrainer

Detailed Description

The Component class uses a ComponentPeer internally to create and manage a real operating-system window.

This is an abstract base class - the platform specific code contains implementations of it for the various platforms.

User-code should very rarely need to have any involvement with this class.

See also: Component::createNewPeer

Member Enumeration Documentation

enum ComponentPeer::StyleFlags

A combination of these flags is passed to the ComponentPeer constructor.

Enumerator
windowAppearsOnTaskbar	Indicates that the window should have a corresponding entry on the taskbar (ignored on MacOSX)
windowIsTemporary	Indicates that the window is a temporary popup, like a menu, tooltip, etc.
windowIgnoresMouseClicks	Indicates that the window should let mouse clicks pass through it (may not be possible on some platforms).
windowHasTitleBar	Indicates that the window should have a normal OS-specific title bar and frame. if not specified, the window will be borderless.
windowIsResizable	Indicates that the window should have a resizable border.
windowHasMinimiseButton	Indicates that if the window has a title bar, it should have a minimise button on it.
windowHasMaximiseButton	Indicates that if the window has a title bar, it should have a maximise button on it.
windowHasCloseButton	Indicates that if the window has a title bar, it should have a close button on it.
windowHasDropShadow	Indicates that the window should have a drop-shadow (this may not be possible on all platforms).
windowRepaintedExplictly	Not intended for public use - this tells a window not to do its own repainting, but only to repaint when the performAnyPendingRepaintsNow() method is called.
windowIgnoresKeyPresses	Tells the window not to catch any keypresses. This can be used for things like plugin windows, to stop them interfering with the host's shortcut keys
windowIsSemiTransparent	Not intended for public use - makes a window transparent.

Constructor & Destructor Documentation

ComponentPeer::ComponentPeer	(	Component &	component,
		int	styleFlags
	)

Creates a peer.

The component is the one that we intend to represent, and the style flags are a combination of the values in the StyleFlags enum

virtual ComponentPeer::~ComponentPeer ( )

virtual

Destructor.

Member Function Documentation

Component& ComponentPeer::getComponent ( )

noexcept

Returns the component being represented by this peer.

int ComponentPeer::getStyleFlags ( ) const

noexcept

Returns the set of style flags that were set when the window was created.

See also: Component::addToDesktop

uint32 ComponentPeer::getUniqueID ( ) const

noexcept

Returns a unique ID for this peer.

Each peer that is created is given a different ID.

virtual void* ComponentPeer::getNativeHandle ( ) const

pure virtual

Returns the raw handle to whatever kind of window is being used.

On windows, this is probably a HWND, on the mac, it's likely to be a WindowRef, but remember there's no guarantees what you'll get back.

virtual void ComponentPeer::setVisible ( bool shouldBeVisible )

pure virtual

Shows or hides the window.

virtual void ComponentPeer::setTitle ( const String & title )

pure virtual

Changes the title of the window.

virtual bool ComponentPeer::setDocumentEditedStatus ( bool edited )

virtual

If this type of window is capable of indicating that the document in it has been edited, then this changes its status.

For example in OSX, this changes the appearance of the close button.

Returns: true if the window has a mechanism for showing this, or false if not.

virtual void ComponentPeer::setRepresentedFile ( const File & )

virtual

If this type of window is capable of indicating that it represents a file, then this lets you set the file.

E.g. in OSX it'll show an icon for the file in the title bar.

virtual void ComponentPeer::setBounds	(	const Rectangle< int > &	newBounds,
		bool	isNowFullScreen
	)

pure virtual

Moves and resizes the window.

If the native window is contained in another window, then the coordinates are relative to the parent window's origin, not the screen origin.

This should result in a callback to handleMovedOrResized().

void ComponentPeer::updateBounds ( )

Updates the peer's bounds to match its component.

virtual Rectangle<int> ComponentPeer::getBounds ( ) const

pure virtual

Returns the current position and size of the window.

If the native window is contained in another window, then the coordinates are relative to the parent window's origin, not the screen origin.

virtual Point<float> ComponentPeer::localToGlobal ( Point< float > relativePosition )

pure virtual

Converts a position relative to the top-left of this component to screen coordinates.

virtual Point<float> ComponentPeer::globalToLocal ( Point< float > screenPosition )

pure virtual

Converts a screen coordinate to a position relative to the top-left of this component.

Point<int> ComponentPeer::localToGlobal ( Point< int > relativePosition )

Converts a position relative to the top-left of this component to screen coordinates.

Point<int> ComponentPeer::globalToLocal ( Point< int > screenPosition )

Converts a screen coordinate to a position relative to the top-left of this component.

virtual Rectangle<int> ComponentPeer::localToGlobal ( const Rectangle< int > & relativePosition )

virtual

Converts a rectangle relative to the top-left of this component to screen coordinates.

virtual Rectangle<int> ComponentPeer::globalToLocal ( const Rectangle< int > & screenPosition )

virtual

Converts a screen area to a position relative to the top-left of this component.

Rectangle<int> ComponentPeer::getAreaCoveredBy ( Component & subComponent ) const

Returns the area in peer coordinates that is covered by the given sub-comp (which may be at any depth)

virtual void ComponentPeer::setMinimised ( bool shouldBeMinimised )

pure virtual

Minimises the window.

virtual bool ComponentPeer::isMinimised ( ) const

pure virtual

True if the window is currently minimised.

virtual void ComponentPeer::setFullScreen ( bool shouldBeFullScreen )

pure virtual

Enable/disable fullscreen mode for the window.

virtual bool ComponentPeer::isFullScreen ( ) const

pure virtual

True if the window is currently full-screen.

virtual bool ComponentPeer::isKioskMode ( ) const

virtual

True if the window is in kiosk-mode.

void ComponentPeer::setNonFullScreenBounds ( const Rectangle< int > & newBounds )

noexcept

Sets the size to restore to if fullscreen mode is turned off.

const Rectangle<int>& ComponentPeer::getNonFullScreenBounds ( ) const

noexcept

Returns the size to restore to if fullscreen mode is turned off.

virtual void ComponentPeer::setIcon ( const Image & newIcon )

pure virtual

Attempts to change the icon associated with this window.

void ComponentPeer::setConstrainer ( ComponentBoundsConstrainer * newConstrainer )

noexcept

Sets a constrainer to use if the peer can resize itself.

The constrainer won't be deleted by this object, so the caller must manage its lifetime.

ComponentBoundsConstrainer* ComponentPeer::getConstrainer ( ) const

noexcept

Returns the current constrainer, if one has been set.

virtual bool ComponentPeer::contains	(	Point< int >	localPos,
		bool	trueIfInAChildWindow
	)		const

pure virtual

Checks if a point is in the window.

The position is relative to the top-left of this window, in unscaled peer coordinates. If trueIfInAChildWindow is false, then this returns false if the point is actually inside a child of this window.

virtual BorderSize<int> ComponentPeer::getFrameSize ( ) const

pure virtual

Returns the size of the window frame that's around this window.

Whether or not the window has a normal window frame depends on the flags that were set when the window was created by Component::addToDesktop()

void ComponentPeer::handleMovedOrResized ( )

This is called when the window's bounds change.

A peer implementation must call this when the window is moved and resized, so that this method can pass the message on to the component.

virtual void ComponentPeer::handleScreenSizeChange ( )

virtual

This is called if the screen resolution changes.

A peer implementation must call this if the monitor arrangement changes or the available screen size changes.

void ComponentPeer::handlePaint ( LowLevelGraphicsContext & contextToPaintTo )

This is called to repaint the component into the given context.

virtual bool ComponentPeer::setAlwaysOnTop ( bool alwaysOnTop )

pure virtual

Sets this window to either be always-on-top or normal.

Some kinds of window might not be able to do this, so should return false.

virtual void ComponentPeer::toFront ( bool makeActive )

pure virtual

Brings the window to the top, optionally also giving it focus.

virtual void ComponentPeer::toBehind ( ComponentPeer * other )

pure virtual

Moves the window to be just behind another one.

void ComponentPeer::handleBroughtToFront ( )

Called when the window is brought to the front, either by the OS or by a call to toFront().

virtual bool ComponentPeer::isFocused ( ) const

pure virtual

True if the window has the keyboard focus.

virtual void ComponentPeer::grabFocus ( )

pure virtual

Tries to give the window keyboard focus.

void ComponentPeer::handleFocusGain ( )

Called when the window gains keyboard focus.

void ComponentPeer::handleFocusLoss ( )

Called when the window loses keyboard focus.

Component* ComponentPeer::getLastFocusedSubcomponent ( ) const

noexcept

bool ComponentPeer::handleKeyPress	(	int	keyCode,
		juce_wchar	textCharacter
	)

Called when a key is pressed.

For keycode info, see the KeyPress class. Returns true if the keystroke was used.

bool ComponentPeer::handleKeyPress ( const KeyPress & key )

Called when a key is pressed.

Returns true if the keystroke was used.

bool ComponentPeer::handleKeyUpOrDown ( bool isKeyDown )

Called whenever a key is pressed or released.

Returns true if the keystroke was used.

void ComponentPeer::handleModifierKeysChange ( )

Called whenever a modifier key is pressed or released.

virtual void ComponentPeer::textInputRequired	(	Point< int >	position,
		TextInputTarget &
	)

pure virtual

Tells the window that text input may be required at the given position.

This may cause things like a virtual on-screen keyboard to appear, depending on the OS.

virtual void ComponentPeer::dismissPendingTextInput ( )

virtual

If there's some kind of OS input-method in progress, this should dismiss it.

TextInputTarget* ComponentPeer::findCurrentTextInputTarget ( )

Returns the currently focused TextInputTarget, or null if none is found.

virtual void ComponentPeer::repaint ( const Rectangle< int > & area )

pure virtual

Invalidates a region of the window to be repainted asynchronously.

virtual void ComponentPeer::performAnyPendingRepaintsNow ( )

pure virtual

This can be called (from the message thread) to cause the immediate redrawing of any areas of this window that need repainting.

You shouldn't ever really need to use this, it's mainly for special purposes like supporting audio plugins where the host's event loop is out of our control.

virtual void ComponentPeer::setAlpha ( float newAlpha )

pure virtual

Changes the window's transparency.

void ComponentPeer::handleMouseEvent	(	int	touchIndex,
		Point< float >	positionWithinPeer,
		ModifierKeys	newMods,
		float	pressure,
		int64	time
	)

void ComponentPeer::handleMouseWheel	(	int	touchIndex,
		Point< float >	positionWithinPeer,
		int64	time,
		const MouseWheelDetails &
	)

void ComponentPeer::handleMagnifyGesture	(	int	touchIndex,
		Point< float >	positionWithinPeer,
		int64	time,
		float	scaleFactor
	)

void ComponentPeer::handleUserClosingWindow ( )

bool ComponentPeer::handleDragMove ( const DragInfo & )

bool ComponentPeer::handleDragExit ( const DragInfo & )

bool ComponentPeer::handleDragDrop ( const DragInfo & )

static int ComponentPeer::getNumPeers ( )

staticnoexcept

Returns the number of currently-active peers.

See also: getPeer

static ComponentPeer* ComponentPeer::getPeer ( int index )

staticnoexcept

Returns one of the currently-active peers.

See also: getNumPeers

static ComponentPeer* ComponentPeer::getPeerFor ( const Component * )

staticnoexcept

Returns the peer that's attached to the given component, or nullptr if there isn't one.

static bool ComponentPeer::isValidPeer ( const ComponentPeer * peer )

staticnoexcept

Checks if this peer object is valid.

See also: getNumPeers

virtual StringArray ComponentPeer::getAvailableRenderingEngines ( )

pure virtual

virtual int ComponentPeer::getCurrentRenderingEngine ( ) const

virtual

virtual void ComponentPeer::setCurrentRenderingEngine ( int index )

virtual

Member Data Documentation

Component& ComponentPeer::component

protected

const int ComponentPeer::styleFlags

protected

Rectangle<int> ComponentPeer::lastNonFullscreenBounds

protected

ComponentBoundsConstrainer* ComponentPeer::constrainer

protected

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

juce_ComponentPeer.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation