GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTSETINITIALFOCUS (3)

NAME

XmtSetInitialFocus() - set the widget to receive the initial keyboard focus in a dialog.

CONTENTS

SYNOPSIS

   #include <Xmt/Xmt.h>

   void XmtSetInitialFocus(Widget dialog, Widget initial)

ARGUMENTS

INPUTS
dialog An XmBulletinBoard widget or a subclass; generally the toplevel widget of a dialog box.
initial The descendant of dialog that it to receive the keyboard focus when dialog first pops up or other wise receives the focus.

DESCRIPTION

XmtSetInitialFocus() specifies that the widget initial should be given keyboard focus when dialog is next given the focus-generally this means when it is first popped up. Dialog boxes that use the XmBulletinBoard widget or a subclass such as the XmForm or XmtLayout widgets will give the initial focus to the default button by default. This is not always desirable, as with the XmPromptDialog where initial focus should be set to the internal text widget.

In Motif 1.2, this function simply sets the XmNinitialFocus resource of dialog. That resource is new with 1.2, however, so in Motif 1.1, XmtSetInitialFocus() must arrange to assign the focus itself. This cannot be done until the dialog widget has received focus itself, and it cannot be done right after popping up the dialog because the window manager imposes an unpredictable delay between the time a window is mapped and the time it actually appears and receives focus. So in Motif 1.1, XmtSetInitialFocus() registers a focus callback which registers a timer procedure which sets the focus to the specified initial widget. XmtSetInitialFocus() exists as a utility routine precisely because this process is so complicated.

SEE ALSO

Chapter 8, Utility Functions.
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTSETINITIALFOCUS (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.