VkResizer(3x)VkResizer(3x)NAMEVkResizer - 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 DESCRIPTIONSVkResizer()
VkResizer(Boolean autoAdjust = False,
Boolean liveResize = False);
virtual void ~VkResizer(void);
Page 1
VkResizer(3x)VkResizer(3x)
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);
Page 2
VkResizer(3x)VkResizer(3x)
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
Page 3
