Base class for the backend. More...

#include <TGUI/Backend.hpp>

Inheritance diagram for tgui::BackendBase:

Public Member Functions
	BackendBase ()=default
	Default constructor.

	BackendBase (const BackendBase &)=delete

BackendBase &	operator= (const BackendBase &)=delete

virtual	~BackendBase ()=default
	Virtual destructor.

void	setDestroyOnLastGuiDetatch (bool destroyOnDetatch)
	Informs the backend whether it should destroy itself when the last Gui is detached from it.

virtual void	attachGui (GuiBase *gui)=0
	Informs the backend that a new gui object has been created.

virtual void	detatchGui (GuiBase *gui)=0
	Informs the backend that a gui object is being destroyed.

virtual Font	createDefaultFont ()=0
	Creates and returns the default font for all widgets.

virtual std::shared_ptr< BackendFontBase >	createFont ()=0
	Creates a new font object.

virtual std::shared_ptr< BackendTextBase >	createText ()=0
	Creates a new text object.

virtual std::shared_ptr< BackendTextureBase >	createTexture ()=0
	Creates a new texture object.

virtual void	setMouseCursorStyle (Cursor::Type type, const std::uint8_t *pixels, Vector2u size, Vector2u hotspot)=0
	Changes the look of a certain mouse cursor by using a bitmap.

virtual void	resetMouseCursorStyle (Cursor::Type type)=0
	Changes the look of a certain mouse cursor back to the system theme.

virtual void	setMouseCursor (GuiBase *gui, Cursor::Type type)=0
	Changes the mouse cursor when the mouse is on top of the window to which the gui is attached.

virtual void	openVirtualKeyboard (const FloatRect &inputRect)=0
	Opens the virtual keyboard on Android and iOS.

virtual void	closeVirtualKeyboard ()=0
	Closes the virtual keyboard on Android and iOS.

virtual bool	isKeyboardModifierPressed (Event::KeyModifier modifierKey)=0
	Checks the state for one of the modifier keys.

virtual void	setClipboard (const String &contents)
	Changes the contents of the clipboard.

virtual String	getClipboard () const
	Returns the contents of the clipboard.

virtual std::unique_ptr< std::uint8_t[]>	readFileFromAndroidAssets (const String &filename, std::size_t &fileSize) const
	Uses the AssetManager on Android to read a file and return its contents.

Protected Attributes
bool	m_destroyOnLastGuiDetatch = false

String	m_clipboardContents

Detailed Description

Base class for the backend.

Member Function Documentation

◆ attachGui()

virtual void tgui::BackendBase::attachGui ( GuiBase * gui )

pure virtual

Informs the backend that a new gui object has been created.

Parameters

gui	Newly created gui

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ closeVirtualKeyboard()

virtual void tgui::BackendBase::closeVirtualKeyboard ( )

pure virtual

Closes the virtual keyboard on Android and iOS.

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ createDefaultFont()

virtual Font tgui::BackendBase::createDefaultFont ( )

pure virtual

Creates and returns the default font for all widgets.

Returns: Default font

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ createFont()

virtual std::shared_ptr< BackendFontBase > tgui::BackendBase::createFont ( )

pure virtual

Creates a new font object.

Returns: Font that is specific to the backend

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ createText()

virtual std::shared_ptr< BackendTextBase > tgui::BackendBase::createText ( )

pure virtual

Creates a new text object.

Returns: Text that is specific to the backend

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ createTexture()

virtual std::shared_ptr< BackendTextureBase > tgui::BackendBase::createTexture ( )

pure virtual

Creates a new texture object.

Returns: Texture that is specific to the backend

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ detatchGui()

virtual void tgui::BackendBase::detatchGui ( GuiBase * gui )

pure virtual

Informs the backend that a gui object is being destroyed.

Parameters

gui	Gui object that is about to be deconstructed

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ getClipboard()

virtual String tgui::BackendBase::getClipboard ( ) const

virtual

Returns the contents of the clipboard.

Returns: Clipboard contents

Reimplemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ isKeyboardModifierPressed()

virtual bool tgui::BackendBase::isKeyboardModifierPressed ( Event::KeyModifier modifierKey )

pure virtual

Checks the state for one of the modifier keys.

Parameters

modifierKey The modifier key of which the state is being queried

Returns: Whether queries modifier key is being pressed

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ openVirtualKeyboard()

virtual void tgui::BackendBase::openVirtualKeyboard ( const FloatRect & inputRect )

pure virtual

Opens the virtual keyboard on Android and iOS.

Parameters

inputRect Part of the screen where the text input is located

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ readFileFromAndroidAssets()

virtual std::unique_ptr< std::uint8_t[]> tgui::BackendBase::readFileFromAndroidAssets	(	const String &	filename,
		std::size_t &	fileSize
	)		const

virtual

Uses the AssetManager on Android to read a file and return its contents.

Parameters

filename	Path to the file to read
fileSize	Size of the file, to be filled in by this function if loading succeeds (untouched on failure)

Returns: File contents if the file was successfully read, or a nullptr on failure or if platform isn't Android.

◆ resetMouseCursorStyle()

virtual void tgui::BackendBase::resetMouseCursorStyle ( Cursor::Type type )

pure virtual

Changes the look of a certain mouse cursor back to the system theme.

Parameters

type	Cursor that should no longer use a custom bitmap

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ setClipboard()

virtual void tgui::BackendBase::setClipboard ( const String & contents )

virtual

Changes the contents of the clipboard.

Parameters

contents New contents of the clipboard

Reimplemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ setDestroyOnLastGuiDetatch()

void tgui::BackendBase::setDestroyOnLastGuiDetatch ( bool destroyOnDetatch )

Informs the backend whether it should destroy itself when the last Gui is detached from it.

Parameters

destroyOnDetatch Should setBackend(nullptr) be called when there are no more Gui objects left?

This function will be called with "true" as parameter if the Backend is created by a Gui object.

◆ setMouseCursor()

virtual void tgui::BackendBase::setMouseCursor	(	GuiBase *	gui,
		Cursor::Type	type
	)

pure virtual

Changes the mouse cursor when the mouse is on top of the window to which the gui is attached.

Parameters

gui	The gui that represents the window for which the mouse cursor should be changed
type	Which cursor to use

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ setMouseCursorStyle()

virtual void tgui::BackendBase::setMouseCursorStyle	(	Cursor::Type	type,
		const std::uint8_t *	pixels,
		Vector2u	size,
		Vector2u	hotspot
	)

pure virtual

Changes the look of a certain mouse cursor by using a bitmap.

Parameters

type	Cursor that should make use of the bitmap
pixels	Pointer to an array with 4size.xsize.y elements, representing the pixels in 32-bit RGBA format
size	Size of the cursor
hotspot	Pixel coordinate within the cursor image which will be located exactly at the mouse pointer position

Implemented in tgui::BackendSDL, and tgui::BackendSFML.

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

include/TGUI/Backend.hpp

TGUI

Public Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ attachGui()

◆ closeVirtualKeyboard()

◆ createDefaultFont()

◆ createFont()

◆ createText()

◆ createTexture()

◆ detatchGui()

◆ getClipboard()

◆ isKeyboardModifierPressed()

◆ openVirtualKeyboard()

◆ readFileFromAndroidAssets()

◆ resetMouseCursorStyle()

◆ setClipboard()

◆ setDestroyOnLastGuiDetatch()

◆ setMouseCursor()

◆ setMouseCursorStyle()