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
       order 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_focusNext 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)
