Class: TInheritableGroupHandle

Declaration: AttributeGroup.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TAttributeGroupHandle

Inherited By:

None.

Purpose:

A descendant of TAttributeGroupHandle, this class supports a hierarchy of reference counted internal attribute groups. The only thing this class does differently from TAttributeGroupHandle is to allocate an internal attribute group of TInternalInheritableGroup in its constructors and to handle the overloaded assignment operator correctly.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

This is a concrete class.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TInheritableGroupHandle::TInheritableGroupHandle

TInheritableGroupHandle ()
TInheritableGroupHandle (const TInheritableGroupHandle & group)

Interface Category:

API.

Purpose:

Default constructor. Automatically creates an object of class TInternalInheritableGroup.
Copy constructor. Adds a reference to an existing object of class TInternalInheritableGroup.

Calling Context:

Called by the stream-in operators and to create a new attribute group.
Called to copy an object.

Parameters:

Takes no parameters.
const TAttributeGroupHandle & copyFrom -The attribute group handle to be copied.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TInheritableGroupHandle::~TInheritableGroupHandle

virtual ~ TInheritableGroupHandle ()

Interface Category:

API.

Purpose:

Destructor. Decreases the reference count of the corresponding internal attribute group by one.

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

TInheritableGroupHandle & operator =(const TInheritableGroupHandle & group)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Called when an object is assigned to another compatible object.

Parameters:

const TInheritableGroupHandle & group -The attribute group 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: TInheritableGroupHandle::GetInternalAttributeGroup

virtual TInternalAttributeGroup * GetInternalAttributeGroup () const

Interface Category:

API.

Purpose:

Developers should treat this function as protected.

Calling Context:

Called by TAttributeGroupHandle.

Parameters:

Takes no parameters.

Return Value:

The internal attribute group.

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.