table of contents
| wxTextAttr(3erl) | Erlang Module Definition | wxTextAttr(3erl) |
NAME¶
wxTextAttr - Functions for wxTextAttr class
DESCRIPTION¶
wxTextAttr represents the character and paragraph attributes, or style, for a range of text in a wxTextCtrl or wxRichTextCtrl (not implemented in wx).
When setting up a wxTextAttr object, pass a bitlist mask to setFlags/2 to indicate which style elements should be changed. As a convenience, when you call a setter such as SetFont, the relevant bit will be set.
See: wxTextCtrl, wxRichTextCtrl (not implemented in wx)
wxWidgets docs: wxTextAttr
DATA TYPES¶
wxTextAttr() = wx:wx_object()
EXPORTS¶
new() -> wxTextAttr()
Constructors.
new(ColText) -> wxTextAttr()
new(Attr) -> wxTextAttr()
Types:
new(ColText, Options :: [Option]) -> wxTextAttr()
Types:
Option =
{colBack, wx:wx_colour()} |
{font, wxFont:wxFont()} |
{alignment, wx:wx_enum()}
getAlignment(This) -> wx:wx_enum()
Types:
Returns the alignment flags.
See ?wxTextAttrAlignment for a list of available styles.
getBackgroundColour(This) -> wx:wx_colour4()
Types:
Returns the background colour.
getFont(This) -> wxFont:wxFont()
Types:
Creates and returns a font specified by the font attributes in the wxTextAttr object.
Note that wxTextAttr does not store a wxFont object, so this is only a temporary font.
For greater efficiency, access the font attributes directly.
getFontEncoding(This) -> wx:wx_enum()
Types:
Returns the font encoding.
getFontFaceName(This) -> unicode:charlist()
Types:
Returns the font face name.
getFontSize(This) -> integer()
Types:
Returns the font size in points.
getFontStyle(This) -> wx:wx_enum()
Types:
Returns the font style.
getFontUnderlined(This) -> boolean()
Types:
Returns true if the font is underlined.
getFontWeight(This) -> wx:wx_enum()
Types:
Returns the font weight.
getLeftIndent(This) -> integer()
Types:
Returns the left indent in tenths of a millimetre.
getLeftSubIndent(This) -> integer()
Types:
Returns the left sub-indent in tenths of a millimetre.
getRightIndent(This) -> integer()
Types:
Returns the right indent in tenths of a millimeter.
getTabs(This) -> [integer()]
Types:
Returns an array of tab stops, each expressed in tenths of a millimeter.
Each stop is measured from the left margin and therefore each value must be larger than the last.
getTextColour(This) -> wx:wx_colour4()
Types:
Returns the text foreground colour.
hasBackgroundColour(This) -> boolean()
Types:
Returns true if the attribute object specifies a background colour.
hasFont(This) -> boolean()
Types:
Returns true if the attribute object specifies any font attributes.
hasTextColour(This) -> boolean()
Types:
Returns true if the attribute object specifies a text foreground colour.
getFlags(This) -> integer()
Types:
Returns flags indicating which attributes are applicable.
See setFlags/2 for a list of available flags.
isDefault(This) -> boolean()
Types:
Returns false if we have any attributes set, true otherwise.
setAlignment(This, Alignment) -> ok
Types:
Alignment = wx:wx_enum()
Sets the paragraph alignment.
See ?wxTextAttrAlignment enumeration values.
Of these, wxTEXT_ALIGNMENT_JUSTIFIED is unimplemented. In future justification may be supported when printing or previewing, only.
setBackgroundColour(This, ColBack) -> ok
Types:
ColBack = wx:wx_colour()
Sets the background colour.
setFlags(This, Flags) -> ok
Types:
Flags = integer()
Sets the flags determining which styles are being specified.
The ?wxTextAttrFlags values can be passed in a bitlist.
setFont(This, Font) -> ok
Types:
Font = wxFont:wxFont()
setFont(This, Font, Options :: [Option]) -> ok
Types:
Font = wxFont:wxFont()
Option = {flags, integer()}
Sets the attributes for the given font.
Note that wxTextAttr does not store an actual wxFont object.
setFontEncoding(This, Encoding) -> ok
Types:
Encoding = wx:wx_enum()
Sets the font encoding.
setFontFaceName(This, FaceName) -> ok
Types:
FaceName = unicode:chardata()
Sets the font face name.
setFontFamily(This, Family) -> ok
Types:
Family = wx:wx_enum()
Sets the font family.
setFontSize(This, PointSize) -> ok
Types:
PointSize = integer()
Sets the font size in points.
setFontPointSize(This, PointSize) -> ok
Types:
PointSize = integer()
Sets the font size in points.
setFontPixelSize(This, PixelSize) -> ok
Types:
PixelSize = integer()
Sets the font size in pixels.
setFontStyle(This, FontStyle) -> ok
Types:
FontStyle = wx:wx_enum()
Sets the font style (normal, italic or slanted).
setFontUnderlined(This, Underlined) -> ok
Types:
Underlined = boolean()
Sets the font underlining (solid line, text colour).
setFontWeight(This, FontWeight) -> ok
Types:
FontWeight = wx:wx_enum()
Sets the font weight.
setLeftIndent(This, Indent) -> ok
Types:
Indent = integer()
setLeftIndent(This, Indent, Options :: [Option]) -> ok
Types:
Indent = integer()
Option = {subIndent, integer()}
Sets the left indent and left subindent in tenths of a millimetre.
The sub-indent is an offset from the left of the paragraph, and is used for all but the first line in a paragraph.
A positive value will cause the first line to appear to the left of the subsequent lines, and a negative value will cause the first line to be indented relative to the subsequent lines.
wxRichTextBuffer (not implemented in wx) uses indentation to render a bulleted item. The left indent is the distance between the margin and the bullet. The content of the paragraph, including the first line, starts at leftMargin + leftSubIndent. So the distance between the left edge of the bullet and the left of the actual paragraph is leftSubIndent.
setRightIndent(This, Indent) -> ok
Types:
Indent = integer()
Sets the right indent in tenths of a millimetre.
setTabs(This, Tabs) -> ok
Types:
Tabs = [integer()]
Sets the tab stops, expressed in tenths of a millimetre.
Each stop is measured from the left margin and therefore each value must be larger than the last.
setTextColour(This, ColText) -> ok
Types:
ColText = wx:wx_colour()
Sets the text foreground colour.
destroy(This :: wxTextAttr()) -> ok
Destroys the object.
| wx 2.2.2.1 | wxWidgets team. |