Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

wxCaret (3erl)

Name

wxCaret - Functions for wxCaret class

Synopsis

Please see following description for synopsis

Description

wxCaret(3)                 Erlang Module Definition                 wxCaret(3)



NAME
       wxCaret - Functions for wxCaret class

DESCRIPTION
       A  caret is a blinking cursor showing the position where the typed text
       will appear. Text controls usually have their  own  caret  but  wxCaret
       provides a way to use a caret in other windows.

       Currently,  the  caret appears as a rectangle of the given size. In the
       future, it will be possible to specify a bitmap  to  be  used  for  the
       caret shape.

       A caret is always associated with a window and the current caret can be
       retrieved using wxWindow:getCaret/1. The same caret can't be reused  in
       two different windows.

       wxWidgets docs: wxCaret

DATA TYPES
       wxCaret() = wx:wx_object()

EXPORTS
       new(Window, Size) -> wxCaret()

              Types:

                 Window = wxWindow:wxWindow()
                 Size = {W :: integer(), H :: integer()}

       new(Window, Width, Height) -> wxCaret()

              Types:

                 Window = wxWindow:wxWindow()
                 Width = Height = integer()

              Creates  a  caret with the given size (in pixels) and associates
              it with the window.

       create(This, Window, Size) -> boolean()

              Types:

                 This = wxCaret()
                 Window = wxWindow:wxWindow()
                 Size = {W :: integer(), H :: integer()}

       create(This, Window, Width, Height) -> boolean()

              Types:

                 This = wxCaret()
                 Window = wxWindow:wxWindow()
                 Width = Height = integer()

              Creates a caret with the given size (in pixels)  and  associates
              it with the window (same as the equivalent constructors).

       getBlinkTime() -> integer()

              Returns  the blink time which is measured in milliseconds and is
              the time elapsed between 2 inversions of the caret  (blink  time
              of  the  caret  is the same for all carets, so this functions is
              static).

       getPosition(This) -> {X :: integer(), Y :: integer()}

              Types:

                 This = wxCaret()

       getSize(This) -> {W :: integer(), H :: integer()}

              Types:

                 This = wxCaret()

       getWindow(This) -> wxWindow:wxWindow()

              Types:

                 This = wxCaret()

              Get the window the caret is associated with.

       hide(This) -> ok

              Types:

                 This = wxCaret()

              Hides the caret, same as Show(false).

       isOk(This) -> boolean()

              Types:

                 This = wxCaret()

              Returns true if the caret was created successfully.

       isVisible(This) -> boolean()

              Types:

                 This = wxCaret()

              Returns true if the caret is visible and false if it  is  perma-
              nently  hidden  (if  it  is blinking and not shown currently but
              will be after the next blink, this method still returns true).

       move(This, Pt) -> ok

              Types:

                 This = wxCaret()
                 Pt = {X :: integer(), Y :: integer()}

       move(This, X, Y) -> ok

              Types:

                 This = wxCaret()
                 X = Y = integer()

              Move the caret to given position (in logical coordinates).

       setBlinkTime(Milliseconds) -> ok

              Types:

                 Milliseconds = integer()

              Sets the blink time for all the carets.

              Warning: Under Windows, this function will change the blink time
              for  all  carets permanently (until the next time it is called),
              even for carets in other applications.

              See: getBlinkTime/0

       setSize(This, Size) -> ok

              Types:

                 This = wxCaret()
                 Size = {W :: integer(), H :: integer()}

       setSize(This, Width, Height) -> ok

              Types:

                 This = wxCaret()
                 Width = Height = integer()

              Changes the size of the caret.

       show(This) -> ok

              Types:

                 This = wxCaret()

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

              Types:

                 This = wxCaret()
                 Option = {show, boolean()}

              Shows or hides the caret.

              Notice that if the caret was hidden N times, it must be shown  N
              times as well to reappear on the screen.

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

              Destroys the object.



wxWidgets team.                    wx 2.1.1                         wxCaret(3)