[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    ShowFrame(3X) manual page Table of Contents

Name

ShowFrame - IVFrame classes that respond to enter and leave events

Remarks:

There is no corresponding Motif widget for this interactor. It may not be suitable for Motif user interface design. See Frame(3X) with a BevelType of BevelHighlight as a possible replacement.

Synopsis

#include <ivplus/frame.h>

Description

ShowFrame is an IVFrame subclass that outlines another interactor based on enter and leave events. There are two classes derived from ShowFrame: TitleFrame and BorderFrame.

ShowFrame is an abstract base class.

Class Hierarchy

ShowFrame->IVFrame->Interactor

Constructors

ShowFrame(Interactor* = nil, int width = 1)

ShowFrame(const char* instanceName, Interactor* = nil, int width = 1)

Construct a showframe. Since ShowFrame is an abstract base class, these constructors are protected. If the given interactor is not nil, it is inserted as the showframe’s component. The showframe extends width pixels outside of the interactor.

ShowFrame(Interactor*, int left, int bottom, int right, int top)

This constructor is used by subclasses to explicitly set the width of each line in the outline. The integers specify the width of the left, bottom, right, and top lines, respectively.

Public Operations

virtual void Handle(Event&)

Showframes listen for enter and leave events. By default the Handle() operation checks the events. When an EnterEvent is received, InsideFrame(true) is called. When a LeaveEvent is received, InsideFrame(false) is called. If any other event is received, it is passed on to HandleInput() and in turn calls Handle() on the frame’s components.

virtual void HandleInput(Event&)

Calls the Handle() operation for all components contained inside the show frame. This operation only gets called if the event is not an EnterEvent or LeaveEvent.

virtual void InsideFrame(boolean)

The showframe implementation of InsideFrame() does nothing. It is meant to be re-defined in derived classes.

Protected Operations

virtual void IVFrame::Reconfig()

Calculates the shape of the frame based on the size of the interactor that it contains.

virtual void IVFrame::Redraw(IntCoord left, IntCoord bottom, IntCoord right, IntCoord top)

Draws the frame using the given coordinates.

X Resources

None.

Examples

There is no example for this abstract base class. See BorderFrame(3X) and TitleFrame(3X) for examples.

Files


frame.h
frame.C

See Also

BorderFrame(3X) , Event(3X) , Frame(3X) , Interactor(3X) , IVFrame(3X) , MarginFrame(3X) , Scene(3X) , ShadowFrame(3X) , TitleFrame(3X) .


Table of Contents