[comp.windows.x.motif] XmNHelpCallBack: What How Where?

bonnett@seismo.CSS.GOV (H. David Bonnett) (10/24/90)

Can anyone provide a bit of enlightment about the XmNhelpCallback 
mentioned in a variety of places in Young and the OSF/Motif 1.1 docs
It is described in Young (p.74) as being supported by all Motif widgets,
and specifically as the only one called by the LabelWidget.  Ok: I define
,declare and even provide a helpcallback for a given LabelWidget; Now the
question is: When does it get called, and what does the user do to cause
this?.  It is never defined/clarified in the docs I have.

E-mail is appreciated -- A summary shall be provided if needed.

Thanks for your assistance:
-dave "a geographer run amok on unix" bonnett-
 bonnett@seismo.css.gov

klee@wsl.dec.com (Ken Lee) (10/25/90)

According to the Motif programmer's manual, most widgets do not bind a
translation to the helpCallback.  It is up to the application
programmers to add their own translation for these widgets, typically
to a HELP key press.  Note that some Motif widgets, such as the file
selection box, do have a help translation.

-- 
Ken Lee
DEC Western Software Laboratory, Palo Alto, Calif.
Internet: klee@wsl.dec.com
uucp: uunet!decwrl!klee

mikey@eukanuba.wpd.sgi.com (Mike Yang) (10/25/90)

In article <49170@seismo.CSS.GOV>, bonnett@seismo.CSS.GOV (H. David Bonnett) writes:
|> Ok: I define
|> ,declare and even provide a helpcallback for a given LabelWidget; Now the
|> question is: When does it get called, and what does the user do to cause
|> this?.  It is never defined/clarified in the docs I have.

In article <1990Oct24.165335@wsl.dec.com>, klee@wsl.dec.com (Ken Lee) writes:
|> According to the Motif programmer's manual, most widgets do not bind a
|> translation to the helpCallback.  It is up to the application
|> programmers to add their own translation for these widgets, typically
|> to a HELP key press.  Note that some Motif widgets, such as the file
|> selection box, do have a help translation.

In Motif 1.1, almost all widgets have the translation:

	<Key>osfHelp:       Help()

Therefore, pressing the "osfHelp" key while the pointer is over the
widget will invoke its Help callback, if available.  Otherwise, it
looks at its ancestors for a Help callback.

On many systems, the "osfHelp" key is the F1 key.

-----------------------------------------------------------------------
                 Mike Yang        Silicon Graphics, Inc.
               mikey@sgi.com           415/335-1786