![](../../Home/Icons/Home.gif)
![](../icons/UpCNM.gif)
![](../icons/CNMContext.gif)
![](../../Home/Icons/Search.gif)
Taxonomy Categories:
Member Functions:
Interface Category:
API.
Inherits From:
TRecordFieldHandle
Inherited By:
None.
Purpose:
This template is for generic field handle wrappers. For instance, it can be used for TRecordTTextFieldHandle.
Instantiation:
Allocate on the heap or the stack.
Deriving Classes:
TRecordFieldHandle.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
Other Considerations:
None.
- TRecordFieldHandleOf ()
- TRecordFieldHandleOf (const TRecordFieldHandleOfType & fieldHandle)
- TRecordFieldHandleOf (const TRecordFieldHandle & fieldHandle)
Interface Category:
API.
Purpose:
- Default constructor.
- The constructor that creates a field handle for the given field.
- The constructor that creates a field handle for the given field.
Calling Context:
- Called by the stream-in operators and any other function that needs to construct an uninitialized object.
- Call this function directly.
- Call this function directly.
Parameters:
- Takes no parameters.
- const TRecordFieldHandleOfType & fieldHandle -The handle of the field to copy.
- const TRecordFieldHandle & fieldHandle -The handle of the field to copy.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual ~ TRecordFieldHandleOf ()
Interface Category:
API.
Purpose:
Destructor.
Calling Context:
Called to destroy an object.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
TRecordFieldHandleOfType & operator =(const TRecordFieldHandleOfType & fieldHandle)
Interface Category:
API.
Purpose:
Assignment operator.
Calling Context:
Called when an object is assigned to another compatible object.
Parameters:
- const TRecordFieldHandleOfType & fieldHandle -The field to copy.
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.
- virtual AConcreteType GetValue () const
- virtual const AAbstractType & GetValue (AAbstractType & target) const
Interface Category:
API.
Purpose:
- Returns the value of the field by value.
- Returns the value of the field by reference.
Calling Context:
- Call this function directly.
- Call this function directly.
Parameters:
- Takes no parameters.
- AAbstractType & target -On return, holds the value of the field.
Return Value:
The value of the field, or a const reference to the value of the field.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual void SetValue (const AAbstractType & value)
Interface Category:
API.
Purpose:
Sets the value of the field.
Calling Context:
Call this function directly.
Parameters:
- const AAbstractType & value -The new value for the field.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual void Replace (const TRecordFieldHandle & field)
Interface Category:
API.
Purpose:
Replaces the field with the value from the given field.
Calling Context:
Call this function directly.
Parameters:
Return Value:
None.
Exceptions:
Raises an exception if the given field is incompatible.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.