VkResizer(3x)

NAME
     VkResizer - Attachment class for resizing and moving widgets

INHERITS FROM
     VkComponent : VkCallbackObject

HEADER FILE
     #include <Vk/VkResizer.h>

PUBLIC PROTOCOL SUMMARY
   Constructor/Destructor
           VkResizer(Boolean autoAdjust = False,
                     Boolean liveResize = False);
           virtual ~VkResizer(void);


   Configuration
           void setIncrements(int resizeWidth,
                              int resizeHeight,
                              int moveX, int moveY);
           void attach(Widget w);
           void detach(void);
           void adjustGeometry(void);


   Access Functions
           Boolean shown(void);




CLASS DESCRIPTION
     The VkResizer class is an attachment rather than a component.  You use
     the attach method to attach it to an existing widget, and then call the
     show method to make it visible.  Once visible, VkResizer will
     automatically allow the user to resize and move the widget using
     VkResizer's controls.  VkResizer is useful to the developer who wants to
     give the user geometry control over widgets using a consistent
     presentation.


DERIVING SUBCLASSES
     It is not expected that developers would subclass VkResizer.


FUNCTION DESCRIPTIONS
   VkResizer()
           VkResizer(Boolean autoAdjust = False,
                     Boolean liveResize = False);
           virtual void ~VkResizer(void);
          The VkResizer constructor creates an object capable of attaching to
          a widget and displaying geometry controls for the user.  The first
          parameter controls whether VkResizer tracks outside geometry changes
          to its attached widget, for adjustment of its geometry controls.
          The second parameter controls whether the widget itself or a
          rectangle representing the widget area is displayed during geometry
          changes.  Setting the second parameter to True causes intermediate
          geometry changes in the attached widget, which may affect
          performance.

   setIncrements()
           void setIncrements(int resizeWidth,
                              int resizeHeight,
                              int moveX, int moveY);


          VkResizer's geometry manipulations are configurable.  The first two
          parameters specify the resize increments in the horizontal and
          vertical dimension, respectively.  The last two parameters specify
          the move increments in the horizontal and vertical dimension,
          respectively.  Setting an increment to zero prohibits resizing or
          moving in that dimension.

   shown()
          Boolean shown(void);


          This function indicates whether VkResizer is visible and displaying
          its geometry controls.

   attach()
          void attach(Widget w);


          This function is used to attach VkResizer to an existing widget.  If
          VkResizer is already attached to a widget, if first detaches.
          Attaching to a widget sets up VkResizer for geometry control of that
          widget.  If VkResizer is shown, it displays its geometry controls
          around the attached widget.

   detach()
          void detach(void);


          This function detaches VkResizer from its attached widget.  Its
          geometry controls are removed.

   adjustGeometry()
          void adjustGeometry(void);

          This function forces VkResizer to adjust its geometry controls to
          the geometry of its attached widget.  Use this function when auto-
          adjustment was not selected in the VkResizer constructor, and the
          attached widget has changed geometry.

   stateChangedCallback
          static const const char* stateChangedCallback;


          This callback informs the application when VkResizer has modified
          the geometry of its attached widget.  The reason for the callback
          can be VR_resizing, VR_moving, VR_resized, or VR_moved.  VR_resizing
          and VR_moving indicate that resizing or moving are in progress, and
          are sent repeatedly as the user adjusts the geometry.  VR_resized
          and VR_moved indicate that the resizing or moving is complete, and
          are sent when the user releases the VkResizer geometry controls.

INHERITED MEMBER FUNCTIONS
   Inherited from VkComponent
          installDestroyHandler(), removeDestroyHandler(), widgetDestroyed(),
          setDefaultResources(), getResources(), manage(), unmanage(),
          baseWidget(), okToQuit(), _name, _baseWidget, _w, deleteCallback


   Inherited from VkCallbackObject
          callCallbacks(), addCallback(), removeCallback(),
          removeAllCallbacks(),


CLASSES USED BY THIS CLASS
     VkApp

SEE ALSO
     VkComponent, VkApp
     ViewKit Programmer's Guide
     The X Window System, DEC Press, Bob Sheifler and Jim Gettys
     The X Window System Toolkit, DEC Press, Paul Asente and Ralph Swick
     The OSF/Motif Programmers Reference, Prentice Hall, OSF