# Copyright (c) 1995-1996 Sun Microsystems, Inc.
# See the file "license.terms" for information on usage and redistribution
# of this file, and for a DISCLAIMER OF ALL WARRANTIES.
#
#
=head1 NAME
Tk_DrawFocusHighlight - draw the traversal highlight ring for a widget
=for category C Programming
=head1 SYNOPSIS
B<#include E<lt>tk.hE<gt>>
B<Tk_GetPixels(>I<tkwin, gc, width, drawable>B<)>
=head1 ARGUMENTS
=over 4
=item Tk_Window tkwin (in)
Window for which the highlight is being drawn. Used to retrieve
the window's dimensions, among other things.
=item GC gc (in)
Graphics context to use for drawing the highlight.
=item int width (in)
Width of the highlight ring, in pixels.
=item Drawable drawable (in)
Drawable in which to draw the highlight; usually an offscreen
pixmap for double buffering.
=back
=head1 DESCRIPTION
B<Tk_DrawFocusHighlight> is a utility procedure that draws the
traversal highlight ring for a widget.
It is typically invoked by widgets during redisplay.
=head1 KEYWORDS
focus, traversal highlight