Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

wxStaticText (3erl)

Name

wxStaticText - Functions for wxStaticText class

Synopsis

Please see following description for synopsis

Description

wxStaticText(3)            Erlang Module Definition            wxStaticText(3)



NAME
       wxStaticText - Functions for wxStaticText class

DESCRIPTION
       A  static  text  control  displays one or more lines of read-only text.
       wxStaticText supports the three classic text alignments,  label  ellip-
       sization  i.e. replacing parts of the text with the ellipsis ("...") if
       the label doesn't fit into  the  provided  space  and  also  formatting
       markup with wxControl::SetLabelMarkup() (not implemented in wx).

       Styles

       This class supports the following styles:

       See: wxStaticBitmap, wxStaticBox

       This  class is derived (and can use functions) from: wxControl wxWindow
       wxEvtHandler

       wxWidgets docs: wxStaticText

DATA TYPES
       wxStaticText() = wx:wx_object()

EXPORTS
       new() -> wxStaticText()

              Default constructor.

       new(Parent, Id, Label) -> wxStaticText()

              Types:

                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Label = unicode:chardata()

       new(Parent, Id, Label, Options :: [Option]) -> wxStaticText()

              Types:

                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Label = unicode:chardata()
                 Option =
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()}

              Constructor, creating and showing a text control.

              See: create/5

       create(This, Parent, Id, Label) -> boolean()

              Types:

                 This = wxStaticText()
                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Label = unicode:chardata()

       create(This, Parent, Id, Label, Options :: [Option]) -> boolean()

              Types:

                 This = wxStaticText()
                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Label = unicode:chardata()
                 Option =
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()}

              Creation function, for two-step construction.

              For details see new/4.

       getLabel(This) -> unicode:charlist()

              Types:

                 This = wxStaticText()

              Returns the control's label, as it was passed to  wxControl:set-
              Label/2.

              Note  that the returned string may contains mnemonics ("&" char-
              acters) if they were passed to  the  wxControl:setLabel/2  func-
              tion;  use  GetLabelText()  (not  implemented in wx) if they are
              undesired.

              Also note that the returned string is always  the  string  which
              was passed to wxControl:setLabel/2 but may be different from the
              string passed to SetLabelText() (not implemented in  wx)  (since
              this last one escapes mnemonic characters).

       setLabel(This, Label) -> ok

              Types:

                 This = wxStaticText()
                 Label = unicode:chardata()

              Change the label shown in the control.

              Notice  that  since  wxWidgets 3.1.1 this function is guaranteed
              not to do anything if the label didn't really change,  so  there
              is no benefit to checking if the new label is different from the
              current one in the application code.

              See: wxControl:setLabel/2

       wrap(This, Width) -> ok

              Types:

                 This = wxStaticText()
                 Width = integer()

              This functions wraps the controls label  so  that  each  of  its
              lines  becomes  at most width pixels wide if possible (the lines
              are broken at words boundaries so it might not be  the  case  if
              words are too long).

              If  width is negative, no wrapping is done. Note that this width
              is not necessarily the total width of the control, since  a  few
              pixels  for  the border (depending on the controls border style)
              may be added.

              Since: 2.6.2

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

              Destroys the object.



wxWidgets team.                    wx 2.1.1                    wxStaticText(3)