Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

wxTextAttr (3erl)

Name

wxTextAttr - Functions for wxTextAttr class

Synopsis

Please see following description for synopsis

Description

wxTextAttr(3)              Erlang Module Definition              wxTextAttr(3)



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  millime-
              tre.

              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, includ-
              ing 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.



wxWidgets team.                    wx 2.1.1                      wxTextAttr(3)