Scroll to navigation

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:

Attr = wxTextAttr()


new(ColText, Options :: [Option]) -> wxTextAttr()


Types:

ColText = wx:wx_colour()
Option =
{colBack, wx:wx_colour()} |
{font, wxFont:wxFont()} |
{alignment, wx:wx_enum()}


getAlignment(This) -> wx:wx_enum()


Types:

This = wxTextAttr()

Returns the alignment flags.

See ?wxTextAttrAlignment for a list of available styles.


getBackgroundColour(This) -> wx:wx_colour4()


Types:

This = wxTextAttr()

Returns the background colour.


getFont(This) -> wxFont:wxFont()


Types:

This = wxTextAttr()

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:

This = wxTextAttr()

Returns the font encoding.


getFontFaceName(This) -> unicode:charlist()


Types:

This = wxTextAttr()

Returns the font face name.


getFontSize(This) -> integer()


Types:

This = wxTextAttr()

Returns the font size in points.


getFontStyle(This) -> wx:wx_enum()


Types:

This = wxTextAttr()

Returns the font style.


getFontUnderlined(This) -> boolean()


Types:

This = wxTextAttr()

Returns true if the font is underlined.


getFontWeight(This) -> wx:wx_enum()


Types:

This = wxTextAttr()

Returns the font weight.


getLeftIndent(This) -> integer()


Types:

This = wxTextAttr()

Returns the left indent in tenths of a millimetre.


getLeftSubIndent(This) -> integer()


Types:

This = wxTextAttr()

Returns the left sub-indent in tenths of a millimetre.


getRightIndent(This) -> integer()


Types:

This = wxTextAttr()

Returns the right indent in tenths of a millimeter.


getTabs(This) -> [integer()]


Types:

This = wxTextAttr()

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:

This = wxTextAttr()

Returns the text foreground colour.


hasBackgroundColour(This) -> boolean()


Types:

This = wxTextAttr()

Returns true if the attribute object specifies a background colour.


hasFont(This) -> boolean()


Types:

This = wxTextAttr()

Returns true if the attribute object specifies any font attributes.


hasTextColour(This) -> boolean()


Types:

This = wxTextAttr()

Returns true if the attribute object specifies a text foreground colour.


getFlags(This) -> integer()


Types:

This = wxTextAttr()

Returns flags indicating which attributes are applicable.

See setFlags/2 for a list of available flags.


isDefault(This) -> boolean()


Types:

This = wxTextAttr()

Returns false if we have any attributes set, true otherwise.


setAlignment(This, Alignment) -> ok


Types:

This = wxTextAttr()
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:

This = wxTextAttr()
ColBack = wx:wx_colour()

Sets the background colour.


setFlags(This, Flags) -> ok


Types:

This = wxTextAttr()
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:

This = wxTextAttr()
Font = wxFont:wxFont()


setFont(This, Font, Options :: [Option]) -> ok


Types:

This = wxTextAttr()
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:

This = wxTextAttr()
Encoding = wx:wx_enum()

Sets the font encoding.


setFontFaceName(This, FaceName) -> ok


Types:

This = wxTextAttr()
FaceName = unicode:chardata()

Sets the font face name.


setFontFamily(This, Family) -> ok


Types:

This = wxTextAttr()
Family = wx:wx_enum()

Sets the font family.


setFontSize(This, PointSize) -> ok


Types:

This = wxTextAttr()
PointSize = integer()

Sets the font size in points.


setFontPointSize(This, PointSize) -> ok


Types:

This = wxTextAttr()
PointSize = integer()

Sets the font size in points.


setFontPixelSize(This, PixelSize) -> ok


Types:

This = wxTextAttr()
PixelSize = integer()

Sets the font size in pixels.


setFontStyle(This, FontStyle) -> ok


Types:

This = wxTextAttr()
FontStyle = wx:wx_enum()

Sets the font style (normal, italic or slanted).


setFontUnderlined(This, Underlined) -> ok


Types:

This = wxTextAttr()
Underlined = boolean()

Sets the font underlining (solid line, text colour).


setFontWeight(This, FontWeight) -> ok


Types:

This = wxTextAttr()
FontWeight = wx:wx_enum()

Sets the font weight.


setLeftIndent(This, Indent) -> ok


Types:

This = wxTextAttr()
Indent = integer()


setLeftIndent(This, Indent, Options :: [Option]) -> ok


Types:

This = wxTextAttr()
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:

This = wxTextAttr()
Indent = integer()

Sets the right indent in tenths of a millimetre.


setTabs(This, Tabs) -> ok


Types:

This = wxTextAttr()
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:

This = wxTextAttr()
ColText = wx:wx_colour()

Sets the text foreground colour.


destroy(This :: wxTextAttr()) -> ok


Destroys the object.

wx 2.2.2.1 wxWidgets team.