NAME

 
 DialogWidget - Base class of dialog widget classes

NAMESPACE

 
 util

PARENT CLASS

 
 util::TopLevelWidget

SYNOPSIS

 
 DialogWidget <path> ?options?

DESCRIPTION

 
 A DialogWidget is an itk widget for creating dialog windows.  A dialog
 window here is a window with a message at top and a row of buttons at
 bottom. Through inheritance, you can add widgets inbetween.

ITK COMPONENTS

 
 bitmap
        Optional bitmap label.

 bitmapf
        Optional bitmap frame.

 bot
        Button frame at bottom.

 def
        Default frame (for image, bitmap, message...).

 default
        Frame surrounding the default dialog button.

 ext
        Extension frame (for subclasses).

 image
        Optional image label.

 imagef
        Optional image frame.

 text
        Optional message text.

 top
        The top frame has one frame for the message and bitmap and another
        for extensions defined in derived classes.

 button$i
        Components for buttons specified with the -buttons option.  For
        example "buttonOK" for the OK button.

STANDARD OPTIONS

 
 -background -justify -messagefont -messagewidth

WIDGET OPTIONS

 
 -bitmap
        Optional bitmap to display to left of message.

 -buttons
        One or more strings to display in buttons across the bottom of the
        dialog box.

 -default
        Index of button that is to display the default ring (-1 means
        none).

 -image
        Optional image to display above the message.

 -modal
        Flag: if true, grab the screen.

 -text
        Text of message (truncated if too long).

 -title
        Title to display in dialog's decorative frame.

PUBLIC METHODS

 
 activate {}
        Display the window and return the user's selection.

PROTECTED METHODS

 
 add_buttons {}
        Create a row of buttons at the bottom of the dialog.

 init {}
        This method is called after the options have been evaluated.

 set_result {}
        This method may be redefined in a derived class to change the
        value that is returned from activate (default is the number of the
        button selected).

PROTECTED VARIABLES

 
 variable_
        Trace variable name.

SEE ALSO

 
 TopLevelWidget(n)

 


- - - - - -
Last change: 07 May 99