ck_focusNext(n)		     Ck Built-In Commands	       ck_focusNext(n)



______________________________________________________________________________

NAME
       ck_focusNext,  ck_focusPrev - Utility procedures for managing the input
       focus.

SYNOPSIS
       ck_focusNext window
       ck_focusPrev window
_________________________________________________________________


DESCRIPTION
       ck_focusNext is a utility procedure used for  keyboard  traversal.   It
       returns the ``next'' window after window in focus order.	 The focus or-
       der is determined by the stacking order of windows and the structure of
       the  window  hierarchy.	Among siblings, the focus order is the same as
       the stacking order, with the lowest window being first.	 If  a	window
       has  children,  the  window  is visited first, followed by its children
       (recursively), followed by its next sibling.  Top-level	windows	 other
       than window are skipped, so that ck_focusNext never returns a window in
       a different top-level from window.

       After computing the next window,	 ck_focusNext  examines	 the  window's
       -takefocus  option  to see whether it should be skipped.	 If so, ck_fo-
       cusNext continues on to the next window in the focus  order,  until  it
       eventually finds a window that will accept the focus or returns back to
       window.

       ck_focusPrev is similar to ck_focusNext except that it returns the win-
       dow just before window in the focus order.


KEYWORDS
       focus, keyboard traversal, toplevel



Ck				      8.0		       ck_focusNext(n)
