DRIntf.NewAttr Function

Creates an attribute set based on the properties of a field component.

Pascal

function NewAttr(Field: TField; const FieldID: TFieldID; const AttrName: string; const Parent: TAttrID): TAttrID;

C++

TAttrID NewAttr(TField Field, const TFieldID FieldID, const AnsiString AttrName, const TAttrID Parent);

File

DRIntf

Description

Call NewAttr create an attribute set in the data dictionary.

The attributes in the attribute set reflect the current properties of the field component specified by the Field parameter.

If a FieldID is provided, the attribute set is associated with Field ID. To create an attribute set without associating it with a field in the Data Dictionary, set the FieldID parameter to NullFieldID.

The AttrName parameter specifies the name under which the attribute set is stored.

The Parent parameter specifies a parent attribute set from which the new attribute set inherits values. Only field properties that differ from the values in the parent attribute set are saved with the new attribute set. If Parent is NullAttrID, all field properties are saved in the new attribute set.

NewAttr returns the attribute ID for the new attribute set.