Class: TMinimizer

Declaration: WindowControls.h

Taxonomy Categories:

Member Functions:

~TMinimizer
DrawContents
operator<<=
operator>>=
operator=
GetDefaultGraphicSize
CreateGraphicLabel
NeedsClipping
TMinimizer

Interface Category:

API.

Inherits From:

TBooleanControl

Inherited By:

None.

Purpose:

TMinimizer derives from TBooleanControl and implements a control commonly used to minimize (reduce to a tab) a window. This class implements the CommonPoint standard appearance and behavior of a minimizer and is used by TStandardWindow.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

Derive from this class to change the appearance of the minimizer. Override DrawContents.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TMinimizer::~TMinimizer

virtual ~ TMinimizer ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TMinimizer::DrawContents

virtual void DrawContents (TGrafPort & port) const

Interface Category:

API.

Purpose:

Draws the minimizer. Classes deriving from TMinimizer should override this function to implement a minimizer with a different appearance.

Calling Context:

Friend classes or classes deriving from TMinimizer can call this function directly.

Parameters:

TGrafPort & port -The TGrafPort into which to render the minimizer.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

This protected function overrides the inherited TView function.

Member Function: TMinimizer::operator<<=

virtual TStream & operator <<= (TStream & fromwhere)

Interface Category:

API.

Purpose:

Stream-in operator.

Calling Context:

Called to stream in data.

Parameters:

TStream & fromwhere -The stream from which the object streams itself in.

Return Value:

Returns a reference to the stream the object streams itself in from.

Exceptions:

Throws a TInvalidVersionError if the version of the object on the stream is unknown to the version of the shared library installed.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TMinimizer::operator>>=

virtual TStream & operator >>=(TStream & towhere) const

Interface Category:

API.

Purpose:

Stream-out operator.

Calling Context:

Called to stream out data.

Parameters:

TStream & towhere -The stream to which the object streams itself out.

Return Value:

Returns a reference to the stream the object streams itself out to.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TMinimizer::operator=

TMinimizer & operator =(const TMinimizer &)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Call this function by using the operator in an assignment statement.

Parameters:

const TMinimizer & -The object to be copied.

Return Value:

A non-const reference to the left-hand side object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TMinimizer::GetDefaultGraphicSize

virtual void GetDefaultGraphicSize (TGPoint & size) const

Interface Category:

API.

Purpose:

Overridden function to report the default size of the control's display. This function returns a TGPoint of (0,0) since the minimizer control doesn't use a graphic label.

Calling Context:

The framework calls this function.

Parameters:

TGPoint & size -Filled in to be a TGPoint of (0,0).

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

This protected function overrides the inherited TBooleanControl pure virtual function.

Member Function: TMinimizer::CreateGraphicLabel

virtual TGraphicLabel * CreateGraphicLabel () const

Interface Category:

API.

Purpose:

Overridden function to create and return the graphic label that is used as part of the control's presentation. This function returns NIL, since the minimizer control doesn't use a graphic label.

Calling Context:

The framework calls this function once when the graphic is first needed.

Parameters:

Takes no parameters.

Return Value:

Returns NIL, since the minimizer control doesn't use a graphic label.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

This protected function overrides the inherited TBooleanControl pure virtual function.

Member Function: TMinimizer::NeedsClipping

virtual bool NeedsClipping ()

Interface Category:

API.

Purpose:

Tells whether or not the to clip when drawing this view.

Calling Context:

Called by the View system to determine whether or not to clip when drawing this view.

Parameters:

Takes no parameters.

Return Value:

Returns false; the View system should not clip.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

Overrides inherited TView function.

Member Function: TMinimizer::TMinimizer

TMinimizer ()
TMinimizer (MBooleanControlState * delegate)

Interface Category:

API.

Purpose:

Default constructor.
Creates a new minimizer whose control state is the MBooleanControlState object provided.

Calling Context:

Called by the stream-in operators.
Call this function directly.

Parameters:

Takes no parameters.
MBooleanControlState * delegate -The control state for the new minimizer.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Click the icon to mail questions or corrections about this material to Taligent personnel.