Inheritance diagram for RichTextWidget:

Public Member Functions
proto external float	GetContentHeight ()

proto external float	GetLineWidth (int line)

proto external int	GetNumLines ()

proto external void	SetLinesVisibility (int lineFrom, int lineTo, bool visible)
	Sets certain lines visible/hidden.

proto external void	ElideText (int line, float maxWidth, string str)
	Ellides the text.

Public Member Functions inherited from TextWidget
proto external void	SetRotation (float angle)
	Sets rotation of widget around defined center.

proto external float	GetRotation ()
	Returns rotation of widget in degrees.

proto external void	SetPivot (float x, float y)
	Sets pivot around which the widget will rotate.

proto external void	SetTextOffset (float xoff, float yoff)
	Sets top-left corner where text begins in widget.

proto external void	SetLineSpacing (float spacing)
	Sets given spacing between lines.

proto external void	SetDesiredFontSize (int size)
	Sets desired (maximal) font size.

proto external void	SetMinFontSize (int size)
	Sets minimal font size.

proto external void	SetExactFontSize (int size)
	Sets both min font size and desired font size to the same value `size`.

proto external bool	GetTextWrapping ()
	Returns whether the text wraps when it runs out of horizontal space.

proto external void	SetTextWrapping (bool isWrapping)
	Sets whether should the text wrap when it runs out of horizontal space.

proto external void	SetSharpness (float sharpness)
	Sets text sharpness multiplier.

proto external float	GetSharpness ()
	Gets current text sharpness.

proto external void	SetOutline (int outlineSize, int argb=0xFF000000)
	Sets outline style.

proto external int	GetOutlineSize ()

proto external int	GetOutlineColor ()

proto external void	SetShadow (int shadowSize, int shadowARGB=0xFF000000, float shadowOpacity=1, float shadowOffsetX=0, float shadowOffsetY=0)
	Sets shadow style.

proto external int	GetShadowSize ()

proto external int	GetShadowColor ()
	Returns shadow color encoded as ARGB.

proto external float	GetShadowOpacity ()

proto external void	SetItalic (bool italic)
	Sets italic style.

proto external bool	GetItalic ()
	Gets current italic style.

proto external void	SetBold (bool bold)
	Sets bold style.

proto external bool	GetBold ()
	Gets current bold style.

proto external void	SetForceFont (bool force)
	Sets force font.

proto external bool	GetForceFont ()
	Gets current force font.

proto void	SetFont (ResourceName fontResource)
	Sets font used for text drawing in this widget.

proto string	GetText ()
	Returns text in this widget. This is NOT a cheap operation - needs to copy the text.

proto void	SetTextFormat (string text, void param1=NULL, void param2=NULL, void param3=NULL, void param4=NULL, void param5=NULL, void param6=NULL, void param7=NULL, void param8=NULL, void param9=NULL)
	Sets text where given params are inserted to appropriate places in given string.

proto void	GetTextSize (out float sx, out float sy)
	Returns text size in pixels in reference resolution.

proto void	GetShadowOffset (out float sx, out float sy)

proto external void	SetText (string text)
	Sets text for the widget. String-table entries are translated.

Public Member Functions inherited from Widget
proto external void	Update ()

proto external Widget	GetParent ()
	Returns parent in hierarchy, or nullptr.

proto external Widget	GetChildren ()
	Returns children in hierarchy, or nullptr.

proto external Widget	GetSibling ()
	Returns next sibling in hierarchy, or nullptr.

proto external void	RemoveChild (notnull Widget child)

proto external void	SetName (string name)

proto external string	GetName ()

proto external void	SetUserID (int id)
	Sets user ID.

proto external int	GetUserID ()
	Gets user ID.

proto external bool	IsFocusable ()

proto external void	AddChild (notnull Widget child)
	Adds given widget as a child. Possible only if this widget accepts more children.

proto external void	AddHandler (ScriptedWidgetEventHandler eventHandler)
	Add (hook) handler to widget. Adds reference to the handler.

proto external void	RemoveHandler (ScriptedWidgetEventHandler eventHandler)
	Unhook handler from widget. Release reference to the handler.

proto external int	GetNumHandlers ()
	Return number of all handlers attached to widget (C++ & scripted)

proto external ScriptedWidgetEventHandler	GetHandler (int index)
	return widget event handler on given index, when the event handler is not inherited from ScriptedWidgetEventHandler, null is returned

proto external ScriptedWidgetEventHandler	FindHandler (TypeName type)
	return first widget event handler of given type, when none of event handlers has the type null is returned

proto external void	SetVisible (bool show)
	Sets visibility of this widget (VISIBLE flag)

proto external void	SetEnabled (bool enable)
	Sets enabled state of this widget (DISABLED flag)

proto external bool	IsVisible ()
	Returns whether is this widget visible (VISIBLE flag is set)

proto external bool	IsVisibleInHierarchy ()
	Returns whether are this widget and all its ancesstors visible (VISIBLE flag is set)

proto external bool	IsEnabled ()
	Returns whether is this widget enabled (DISABLED flag is not set)

proto external bool	IsEnabledInHierarchy ()
	Returns whether are this widget and all its ancesstors enabled (DISABLED flag is not set)

proto external bool	IsClippingChildren ()
	Returns wheter this widget clips its children.

proto external bool	GetIsColorInherited ()

proto external void	SetIsColorInherited (bool isColorInherited)
	Sets whether this widget inherits color from its parent.

proto external void	SetColor (notnull Color color)
	Sets color of this widget.

proto external void	SetColorInt (int color)
	Set ARGB color.

proto external int	GetColorInt ()

proto external void	SetOpacity (float alpha)
	Sets opacity which applies to this widget and all its descendants.

proto external float	GetOpacity ()

proto external void	SetZOrder (int zOrder)
	Changes z-order value.

proto external int	GetZOrder ()
	Higher values mean more in front.

proto external void	RemoveFromHierarchy ()
	Removes this widget from its parent and from the WidgetManager.

proto external Widget	FindWidget (string pathname)
	Find Widget by path. e.g FindWidget("widget1.widget2.widget3.mywidget")

proto external Widget	FindAnyWidget (string pathname)
	Looks for a widget with given `name` in `this` widget's children.

proto external Widget	FindAnyWidgetById (int user_id)
	Find Widget by userID.

proto external string	GetStyleName ()

proto external WorkspaceWidget	GetWorkspace ()

proto ref Color	GetColor ()
	Returns color of this widget.

proto string	GetNavigation (WidgetNavigationDirection direction, out WidgetNavigationRuleType rule)
	Gets navigation rule for given direction.

proto external void	SetNavigation (WidgetNavigationDirection direction, WidgetNavigationRuleType rule, string explicitTarget=string.Empty)
	Sets navigation rule for given direction.

proto external string	GetTypeName ()

proto external int	GetFlags ()

proto external int	SetFlags (int flags)
	Sets given WidgetFlags for this widget.

proto external int	ClearFlags (int flags)
	Removes all flags.

proto external WidgetType	GetTypeID ()

proto void	GetScreenPos (out float x, out float y)
	Returns position of this widget's top left corner in physical resolution.

proto void	GetScreenSize (out float width, out float height)
	Returns size of this widget in physical resolution.

proto external bool	RemoveCallback (int eventId, int callbackId)
	Remove callback with given callbackId (callback ID is returned from AddCallback method)

proto external bool	RemoveCallbackByOwner (int eventId, Class owner)
	Remove callback with given caller object (in case the callback method is on object instance)

proto external bool	EmitCallback (int eventId)
	Trigger callbacks attached to eventID on the widget (not called over hierarchy)

proto int	AddCallback (int eventId, WidgetEventCallback fn)
	Add callback for given event id and returns callback id.

proto external bool	EmitCustomEvent (int iData, Managed pData)
	Emits custom widget event (called over hierarchy like other widget events).

Public Member Functions inherited from Managed
proto external ref Managed	Clone ()
	Return shallow copy of object, or null if it is not allowed (not public constructor)

Member Function Documentation

◆ ElideText()

proto external void RichTextWidget.ElideText	(	int	line,
		float	maxWidth,
		string	str )

Ellides the text.

Parameters

line	indicates max. line, rest of lines are discarded (hidden).
maxWidth	Indicates when the text will be elided. from 0.0 to 1.0.
str	String to elide the text with. e.g '...' => [Lorem ipsum dol...]

e.g. ElideText(GetNumLines(), 1.0, "...") the text will be elided with "..." when reaches maximum width of parent widget.

only works for left-to-right text, will not elide correctly for right aligned or centered texts.

Its a slow function, should be called only when text is changed.

◆ GetContentHeight()

proto external float RichTextWidget.GetContentHeight ( )

◆ GetLineWidth()

proto external float RichTextWidget.GetLineWidth ( int line )

◆ GetNumLines()

proto external int RichTextWidget.GetNumLines ( )

◆ SetLinesVisibility()

proto external void RichTextWidget.SetLinesVisibility	(	int	lineFrom,
		int	lineTo,
		bool	visible )

Sets certain lines visible/hidden.