Class: TFillAndHairlineFrameBundle

Declaration: Bundles.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TLocalAttributeState

Inherited By:

None.

Purpose:

TFillAndHairlineFrameBundle is a derived class of TLocalAttributeState, and contains imaging information for 2-D graphic objects of the solid-filled, framed (with hairline frame) variety. Because it is derived from the local attribute bundle class, only those attributes pertinent to this form of graphic object need to be overridden. The fill attributes include the fill paint (which determines the color and pattern applied to a geometry's interior) and the transfer mode (which helps determine the actual color of the paint when the object is drawn). The frame attributes describe properties of the object's border. However, because a hairline pen is used here, the user need only be concerned with the paint information for the frame.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::TFillAndHairlineFrameBundle

TFillAndHairlineFrameBundle ()
TFillAndHairlineFrameBundle (const TFillAndHairlineFrameBundle &)
TFillAndHairlineFrameBundle (const TColor & fillColor, const TColor & frameColor)
TFillAndHairlineFrameBundle (const TColor & fillColor, const TTransferMode & fillTransferMode, const TColor & frameColor)

Interface Category:

API.

Purpose:

Default constructor.
Copy constructor.
Creates a fill and hairline frame attribute bundle using the specified values for the fill and frame colors.
Creates a fill and hairline frame attribute bundle using the specified values for the fill and frame colors. Also, a transfer mode is given that will determine the fill region's final color.

Calling Context:

Called by the stream-in operators and can be called directly.
Called to copy an object.
Call this function directly.
Call this function directly.

Parameters:

Takes no parameters.
const TFillAndHairlineFrameBundle & -The object to be copied.
const TColor & fillColor -The color for the fill region.
const TColor & frameColor -The color for the frame.
const TColor & fillColor -The color for the fill region.
const TTransferMode & fillTransferMode -The transfer mode for the fill region.
const TColor & frameColor -The color for the frame.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::~TFillAndHairlineFrameBundle

virtual ~ TFillAndHairlineFrameBundle ()

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: TFillAndHairlineFrameBundle::operator=

TFillAndHairlineFrameBundle & operator =( const TFillAndHairlineFrameBundle &)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Called when an object is assigned to another compatible object.

Parameters:

const TFillAndHairlineFrameBundle & -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: TFillAndHairlineFrameBundle::SetFillColor

void SetFillColor (const TColor & color)

Interface Category:

API.

Purpose:

Sets the fill color for the object.

Calling Context:

Call this function directly.

Parameters:

const TColor & color -The color for the fill region.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::SetFrameColor

void SetFrameColor (const TColor & color)

Interface Category:

API.

Purpose:

Sets the frame color for the graphic object.

Calling Context:

Call this function directly.

Parameters:

const TColor & color -The color for the frame.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::SetFillTransferMode

void SetFillTransferMode (const TTransferMode & transferMode)

Interface Category:

API.

Purpose:

Sets the transfer mode that determines the fill color. If a transfer mode is already defined for this object, it is deleted and replaced with the new transfer mode.

Calling Context:

Call this function directly.

Parameters:

const TTransferMode & transferMode -The new transfer mode to be used.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::GetFillPaint

virtual const TPaint * GetFillPaint () const

Interface Category:

API.

Purpose:

Returns the paint object being used for the fill region of this graphic object.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

Pointer to the paint object being used.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::GetFillTransferMode

virtual const TTransferMode * GetFillTransferMode () const

Interface Category:

API.

Purpose:

Returns a pointer to the transfer mode being used by the fill region.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

A pointer to the transfer mode for the fill region.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::GetFramePaint

virtual const TPaint * GetFramePaint () const

Interface Category:

API.

Purpose:

Returns the paint object being used for this frame.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

Pointer to the paint object being used.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::GetFramePen

virtual const TPen * GetFramePen () const

Interface Category:

API.

Purpose:

Gets the TPen object that is used for the rendering of the frame.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

A pointer to this frame's TPen.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::GetDrawingOperation

virtual EDrawOperation GetDrawingOperation () const

Interface Category:

API.

Purpose:

Returns the EDrawOperation that determines whether to paint the fill, the frame, or both.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

The EDrawingOperation value of the bundle.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TFillAndHairlineFrameBundle::operator>>=

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

Interface Category:

API.

Purpose:

Stream-out operator.

Calling Context:

Called to stream out data.

Parameters:

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

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: TFillAndHairlineFrameBundle::operator<<=

virtual TStream & operator <<= (TStream &)

Interface Category:

API.

Purpose:

Stream-in operator.

Calling Context:

Called to stream in data.

Parameters:

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

Return Value:

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

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.