Class Label
- Namespace
- Forma
- Assembly
- Forma.dll
Displays shaped text with alignment, wrapping, trimming, casing, and visible-character controls.
public class Label : Control, IAddChild<Control>, IAddChild, INotifyPropertyChanged
- Inheritance
-
Label
- Implements
- Derived
- Inherited Members
Constructors
Label()
public Label()
Properties
Autowrap
Legacy convenience switch; true maps to Godot's WordSmart mode.
public bool Autowrap { get; set; }
Property Value
AutowrapMode
public LabelAutowrapMode AutowrapMode { get; set; }
Property Value
ClipText
public bool ClipText { get; set; }
Property Value
EllipsisCharacter
public string EllipsisCharacter { get; set; }
Property Value
Font
public SpriteFont Font { get; set; }
Property Value
- SpriteFont
FontColor
public Color? FontColor { get; set; }
Property Value
- Color?
HorizontalAlignment
public HorizontalAlignment HorizontalAlignment { get; set; }
Property Value
JustificationFlags
public LabelJustificationFlags JustificationFlags { get; set; }
Property Value
LinesSkipped
public int LinesSkipped { get; set; }
Property Value
MaxLinesVisible
public int MaxLinesVisible { get; set; }
Property Value
Padding
public Thickness Padding { get; set; }
Property Value
ParagraphSeparator
public string ParagraphSeparator { get; set; }
Property Value
ParagraphSpacing
public float ParagraphSpacing { get; set; }
Property Value
StructuredTextBidiOverride
public StructuredTextParser StructuredTextBidiOverride { get; set; }
Property Value
Text
public string Text { get; set; }
Property Value
TextDirection
public TextDirection TextDirection { get; set; }
Property Value
TextOverrunBehavior
public LabelTextOverrunBehavior TextOverrunBehavior { get; set; }
Property Value
UIFont
public UIFont UIFont { get; set; }
Property Value
Uppercase
public bool Uppercase { get; set; }
Property Value
VerticalAlignment
public VerticalAlignment VerticalAlignment { get; set; }
Property Value
VisibleCharacters
public int VisibleCharacters { get; set; }
Property Value
VisibleCharactersBehavior
public LabelVisibleCharactersBehavior VisibleCharactersBehavior { get; set; }
Property Value
VisibleRatio
public float VisibleRatio { get; set; }
Property Value
Methods
AdjustTextLayout(TextLayout)
protected virtual TextLayout AdjustTextLayout(TextLayout layout)
Parameters
layoutTextLayout
Returns
DrawLabelChildren(UIRenderContext)
Draws retained child controls after the label's text.
protected void DrawLabelChildren(UIRenderContext context)
Parameters
contextUIRenderContext
DrawLabelText(UIRenderContext)
Draws this label's text. Rich-text derived controls can replace this while retaining child rendering.
protected virtual void DrawLabelText(UIRenderContext context)
Parameters
contextUIRenderContext
GetAutowrapMode()
public LabelAutowrapMode GetAutowrapMode()
Returns
GetCharacterBounds(int)
public virtual Rectangle GetCharacterBounds(int position)
Parameters
positionint
Returns
- Rectangle
GetDisplayLines()
Returns the text as it will be displayed after casing, visible-character, wrapping, and line-limit rules.
public IReadOnlyList<string> GetDisplayLines()
Returns
GetEllipsisChar()
public string GetEllipsisChar()
Returns
GetHorizontalAlignment()
public HorizontalAlignment GetHorizontalAlignment()
Returns
GetJustificationFlags()
public LabelJustificationFlags GetJustificationFlags()
Returns
GetLanguage()
public string GetLanguage()
Returns
GetLineCount()
public int GetLineCount()
Returns
GetLineHeight(int)
public int GetLineHeight(int line = -1)
Parameters
lineint
Returns
GetLinesSkipped()
public int GetLinesSkipped()
Returns
GetMaxLinesVisible()
public int GetMaxLinesVisible()
Returns
GetMinimumSize()
public override Vector2 GetMinimumSize()
Returns
- Vector2
GetOpenTypeFeatures()
public IReadOnlyList<UIFontOpenTypeFeature> GetOpenTypeFeatures()
Returns
GetParagraphSeparator()
public string GetParagraphSeparator()
Returns
GetParagraphSpacing()
public float GetParagraphSpacing()
Returns
GetStructuredTextBidiOverride()
public StructuredTextParser GetStructuredTextBidiOverride()
Returns
GetStructuredTextBidiOverrideOptions()
public IReadOnlyList<object> GetStructuredTextBidiOverrideOptions()
Returns
GetTabStops()
public IReadOnlyList<float> GetTabStops()
Returns
GetText()
public string GetText()
Returns
GetTextDirection()
public TextDirection GetTextDirection()
Returns
GetTextLineSpacing(UIFont)
protected virtual float GetTextLineSpacing(UIFont font)
Parameters
fontUIFont
Returns
GetTextOverrunBehavior()
public LabelTextOverrunBehavior GetTextOverrunBehavior()
Returns
GetTotalCharacterCount()
public int GetTotalCharacterCount()
Returns
GetVerticalAlignment()
public VerticalAlignment GetVerticalAlignment()
Returns
GetVisibleCharacters()
public int GetVisibleCharacters()
Returns
GetVisibleCharactersBehavior()
public LabelVisibleCharactersBehavior GetVisibleCharactersBehavior()
Returns
GetVisibleLineCount()
public int GetVisibleLineCount()
Returns
GetVisibleRatio()
public float GetVisibleRatio()
Returns
IsClippingText()
public bool IsClippingText()
Returns
IsUppercase()
public bool IsUppercase()
Returns
SetAutowrapMode(LabelAutowrapMode)
public void SetAutowrapMode(LabelAutowrapMode mode)
Parameters
modeLabelAutowrapMode
SetClipText(bool)
public void SetClipText(bool enable)
Parameters
enablebool
SetEllipsisChar(string)
public void SetEllipsisChar(string value)
Parameters
valuestring
SetHorizontalAlignment(HorizontalAlignment)
public void SetHorizontalAlignment(HorizontalAlignment alignment)
Parameters
alignmentHorizontalAlignment
SetJustificationFlags(LabelJustificationFlags)
public void SetJustificationFlags(LabelJustificationFlags flags)
Parameters
flagsLabelJustificationFlags
SetLanguage(string)
public void SetLanguage(string language)
Parameters
languagestring
SetLinesSkipped(int)
public void SetLinesSkipped(int lines)
Parameters
linesint
SetMaxLinesVisible(int)
public void SetMaxLinesVisible(int lines)
Parameters
linesint
SetOpenTypeFeatures(IEnumerable<UIFontOpenTypeFeature>)
public void SetOpenTypeFeatures(IEnumerable<UIFontOpenTypeFeature> features)
Parameters
featuresIEnumerable<UIFontOpenTypeFeature>
SetParagraphSeparator(string)
public void SetParagraphSeparator(string paragraphSeparator)
Parameters
paragraphSeparatorstring
SetParagraphSpacing(float)
public void SetParagraphSpacing(float spacing)
Parameters
spacingfloat
SetStructuredTextBidiOverride(StructuredTextParser)
public void SetStructuredTextBidiOverride(StructuredTextParser parser)
Parameters
parserStructuredTextParser
SetStructuredTextBidiOverrideOptions(IEnumerable<object>)
public void SetStructuredTextBidiOverrideOptions(IEnumerable<object> options)
Parameters
optionsIEnumerable<object>
SetTabStops(IEnumerable<float>)
public void SetTabStops(IEnumerable<float> tabStops)
Parameters
tabStopsIEnumerable<float>
SetText(string)
public void SetText(string text)
Parameters
textstring
SetTextDirection(TextDirection)
public void SetTextDirection(TextDirection direction)
Parameters
directionTextDirection
SetTextOverrunBehavior(LabelTextOverrunBehavior)
public void SetTextOverrunBehavior(LabelTextOverrunBehavior behavior)
Parameters
behaviorLabelTextOverrunBehavior
SetUppercase(bool)
public void SetUppercase(bool enable)
Parameters
enablebool
SetVerticalAlignment(VerticalAlignment)
public void SetVerticalAlignment(VerticalAlignment alignment)
Parameters
alignmentVerticalAlignment
SetVisibleCharacters(int)
public void SetVisibleCharacters(int amount)
Parameters
amountint
SetVisibleCharactersBehavior(LabelVisibleCharactersBehavior)
public void SetVisibleCharactersBehavior(LabelVisibleCharactersBehavior behavior)
Parameters
behaviorLabelVisibleCharactersBehavior
SetVisibleRatio(float)
public void SetVisibleRatio(float ratio)
Parameters
ratiofloat