Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

wxHelpEvent (3erl)

Name

wxHelpEvent - Functions for wxHelpEvent class

Synopsis

Please see following description for synopsis

Description

wxHelpEvent(3)             Erlang Module Definition             wxHelpEvent(3)



NAME
       wxHelpEvent - Functions for wxHelpEvent class

DESCRIPTION
       A  help  event  is  sent  when the user has requested context-sensitive
       help. This can either be caused by the application requesting  context-
       sensitive  help  mode via wxContextHelp (not implemented in wx), or (on
       MS Windows) by the system generating a WM_HELP message  when  the  user
       pressed F1 or clicked on the query button in a dialog caption.

       A  help  event  is  sent to the window that the user clicked on, and is
       propagated up the window hierarchy until  the  event  is  processed  or
       there are no more event handlers.

       The  application  should  call wxEvent:getId/1 to check the identity of
       the clicked-on window, and then either show some suitable help or  call
       wxEvent:skip/2 if the identifier is unrecognised.

       Calling  Skip is important because it allows wxWidgets to generate fur-
       ther events for ancestors of the clicked-on window. Otherwise it  would
       be  impossible  to  show  help  for container windows, since processing
       would stop after the first window found.

       See: wxContextHelp (not implemented in wx), wxDialog, Overview events

       This class is derived (and can use functions) from: wxEvent

       wxWidgets docs: wxHelpEvent

EVENTS
       Use wxEvtHandler:connect/3 with wxHelpEventType to subscribe to  events
       of this type.

DATA TYPES
       wxHelpEvent() = wx:wx_object()

       wxHelp() = #wxHelp{type = wxHelpEvent:wxHelpEventType()}

       wxHelpEventType() = help | detailed_help

EXPORTS
       getOrigin(This) -> wx:wx_enum()

              Types:

                 This = wxHelpEvent()

              Returns  the  origin  of  the  help  event  which  is one of the
              wxHelpEvent::Origin (not implemented in wx) values.

              The application may handle events generated using  the  keyboard
              or  mouse  differently, e.g. by using wx_misc:getMousePosition/0
              for the mouse events.

              See: setOrigin/2

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

              Types:

                 This = wxHelpEvent()

              Returns the left-click position of the mouse, in screen  coordi-
              nates.

              This allows the application to position the help appropriately.

       setOrigin(This, Origin) -> ok

              Types:

                 This = wxHelpEvent()
                 Origin = wx:wx_enum()

              Set  the  help  event  origin, only used internally by wxWidgets
              normally.

              See: getOrigin/1

       setPosition(This, Pt) -> ok

              Types:

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

              Sets the left-click position of the  mouse,  in  screen  coordi-
              nates.



wxWidgets team.                    wx 2.1.1                     wxHelpEvent(3)