Skip to main content

EntityProperty

Defined in: src/entities/property.ts:347

A dynamic property associated with the entity.

Extends

Constructors

Constructor

new EntityProperty(dart): EntityProperty

Defined in: src/entities/property.ts:348

Parameters

ParameterType
dartany

Returns

EntityProperty

Overrides

Property.constructor

Properties

PropertyModifierTypeDescriptionInherited fromDefined in
dartreadonlyany-Property.dartsrc/entities/property.ts:122
optionspublicanyAdditional options.Property.optionssrc/entities/property.ts:123
propertyOptionsstaticobject-Property.propertyOptionssrc/entities/property.ts:316
propertyOptions.caption?publicIProperty & IPropertyMetaCustom field caption shown in [PropertyGrid] Deprecated The property will be removed soon. Use friendlyName instead-src/entities/property.ts:87
propertyOptions.category?publicIProperty & IPropertyMetaCorresponding category on the context panel-src/entities/property.ts:69
propertyOptions.choices?publicIProperty & IPropertyMetaList of choices. Applicable to string properties only-src/entities/property.ts:57
propertyOptions.columnTypeFilter?publicIProperty & IPropertyMetaFilter for columns, can be numerical, categorical or directly a column type (string, int...) Applicable when type = Column-src/entities/property.ts:102
propertyOptions.defaultValue?publicIProperty & IPropertyMetaDefault value used for deserialization and cloning. See also initialValue.-src/entities/property.ts:63
propertyOptions.description?publicIProperty & IPropertyMetaProperty description-src/entities/property.ts:33
propertyOptions.editor?publicIProperty & IPropertyMetaCustom editor (such as slider or text area)-src/entities/property.ts:66
propertyOptions.fieldName?publicIProperty & IPropertyMetaName of the corresponding JavaScript field. No need to specify it if it is the same as name.-src/entities/property.ts:93
propertyOptions.format?publicIProperty & IPropertyMetaValue format, such as '0.000'-src/entities/property.ts:72
propertyOptions.friendlyName?publicIProperty & IPropertyMetaCustom field friendly name shown in [PropertyGrid]-src/entities/property.ts:90
propertyOptions.initialValue?publicIProperty & IPropertyMetaInitial value used when initializing UI. See also defaultValue-src/entities/property.ts:60
propertyOptions.inputType?publicIProperty & IPropertyMetaProperty input type-src/entities/property.ts:27
propertyOptions.max?publicIProperty & IPropertyMetaMaximum value. Applicable to numerical properties only-src/entities/property.ts:45
propertyOptions.min?publicIProperty & IPropertyMetaMinimum value. Applicable to numerical properties only-src/entities/property.ts:42
propertyOptions.name?publicIProperty & IPropertyMetaProperty name-src/entities/property.ts:21
propertyOptions.nullable?publicIProperty & IPropertyMetaWhether an empty value is allowed. This is used by validators.-src/entities/property.ts:30
propertyOptions.options?publicIProperty & IPropertyMetaAdditional options.-src/entities/property.ts:98
propertyOptions.semType?publicIProperty & IPropertyMetaSemantic type-src/entities/property.ts:36
propertyOptions.showPlusMinus?publicIProperty & IPropertyMetaWhether a plus/minus clicker appears next to the number input. Applies to numerical columns only.-src/entities/property.ts:54
propertyOptions.showSlider?publicIProperty & IPropertyMetaWhether a slider appears next to the number input. Applies to numerical columns only.-src/entities/property.ts:51
propertyOptions.step?publicIProperty & IPropertyMetaStep to be used in a slider. Only applies to numerical properties.-src/entities/property.ts:48
propertyOptions.tags?publicIProperty & IPropertyMeta--src/entities/property.ts:95
propertyOptions.type?publicIProperty & IPropertyMetaProperty data type. See TYPE.-src/entities/property.ts:24
propertyOptions.units?publicIProperty & IPropertyMetaUnits of measurement. See also: [postfix]-src/entities/property.ts:39
propertyOptions.userEditable?publicIProperty & IPropertyMetaWhether the property should be editable via the UI-src/entities/property.ts:75
propertyOptions.validators?publicIProperty & IPropertyMetaList of validators. It can include [NAMED_VALIDATORS] as well as any pre-defined function names. Signature: validator(x: DG.Type): stringnull. [null] indicates that the value is valid, [string] describes a validation error.-
propertyOptions.valueValidators?publicIProperty & IPropertyMetaList of value validators (functions that take a value and return error message or null)-src/entities/property.ts:83
propertyOptions.viewer?publicIProperty & IPropertyMeta--src/entities/property.ts:105

Accessors

caption

Get Signature

get caption(): string

Defined in: src/entities/property.ts:147

Custom field caption shown in the UI

Deprecated

The property will be removed soon. Use friendlyName instead

Returns

string

Set Signature

set caption(s): void

Defined in: src/entities/property.ts:148

Custom field caption shown in [PropertyGrid]

Deprecated

The property will be removed soon. Use friendlyName instead

Parameters
ParameterType
sstring
Returns

void

Custom field caption shown in [PropertyGrid]

Deprecated

The property will be removed soon. Use friendlyName instead

Inherited from

Property.caption


category

Get Signature

get category(): string

Defined in: src/entities/property.ts:155

Property category

Returns

string

Set Signature

set category(s): void

Defined in: src/entities/property.ts:156

Corresponding category on the context panel

Parameters
ParameterType
sstring
Returns

void

Corresponding category on the context panel

Inherited from

Property.category


choices

Get Signature

get choices(): string[]

Defined in: src/entities/property.ts:236

List of possible values of that property. PropertyGrid will use it to populate combo boxes.

Returns

string[]

Set Signature

set choices(x): void

Defined in: src/entities/property.ts:237

List of choices. Applicable to string properties only

Parameters
ParameterType
xstring[]
Returns

void

List of choices. Applicable to string properties only

Inherited from

Property.choices


columnTypeFilter

Get Signature

get columnTypeFilter(): "string" | "bigint" | "object" | "int" | "double" | "bool" | "byte_array" | "datetime" | "qnum" | "dataframe" | "categorical" | "numerical" | null

Defined in: src/entities/property.ts:249

Column type filter (previously "columnFilter")

Returns

"string" | "bigint" | "object" | "int" | "double" | "bool" | "byte_array" | "datetime" | "qnum" | "dataframe" | "categorical" | "numerical" | null

Filter for columns, can be numerical, categorical or directly a column type (string, int...) Applicable when type = Column

Inherited from

Property.columnTypeFilter


defaultValue

Get Signature

get defaultValue(): any

Defined in: src/entities/property.ts:194

Default value

Returns

any

Set Signature

set defaultValue(s): void

Defined in: src/entities/property.ts:195

Default value used for deserialization and cloning. See also initialValue.

Parameters
ParameterType
sany
Returns

void

Default value used for deserialization and cloning. See also initialValue.

Inherited from

Property.defaultValue


description

Get Signature

get description(): string

Defined in: src/entities/property.ts:182

Description

Returns

string

Set Signature

set description(s): void

Defined in: src/entities/property.ts:183

Property description

Parameters
ParameterType
sstring
Returns

void

Property description

Inherited from

Property.description


editor

Get Signature

get editor(): string

Defined in: src/entities/property.ts:198

Property editor

Returns

string

Set Signature

set editor(s): void

Defined in: src/entities/property.ts:199

Custom editor (such as slider or text area)

Parameters
ParameterType
sstring
Returns

void

Custom editor (such as slider or text area)

Inherited from

Property.editor


format

Get Signature

get format(): string

Defined in: src/entities/property.ts:206

Format to be used for displaying the value.

Returns

string

Set Signature

set format(s): void

Defined in: src/entities/property.ts:207

Value format, such as '0.000'

Parameters
ParameterType
sstring
Returns

void

Value format, such as '0.000'

Inherited from

Property.format


friendlyName

Get Signature

get friendlyName(): string

Defined in: src/entities/property.ts:151

Custom field caption shown in the UI

Returns

string

Set Signature

set friendlyName(s): void

Defined in: src/entities/property.ts:152

Custom field friendly name shown in [PropertyGrid]

Parameters
ParameterType
sstring
Returns

void

Custom field friendly name shown in [PropertyGrid]

Inherited from

Property.friendlyName


get

Get Signature

get get(): PropertyGetter

Defined in: src/entities/property.ts:134

Property getter is a function that accepts one parameter (item) and returns the property value.

Returns

PropertyGetter

Set Signature

set get(x): void

Defined in: src/entities/property.ts:135

Parameters
ParameterType
xPropertyGetter
Returns

void

Inherited from

Property.get


includeInLayout

Get Signature

get includeInLayout(): boolean

Defined in: src/entities/property.ts:170

Applies to viewers properties whether to include the property in the layout or not.

Returns

boolean

Set Signature

set includeInLayout(s): void

Defined in: src/entities/property.ts:171

Parameters
ParameterType
sboolean
Returns

void

Inherited from

Property.includeInLayout


initialValue

Get Signature

get initialValue(): string

Defined in: src/entities/property.ts:190

Initial value used when initializing UI

Returns

string

Set Signature

set initialValue(s): void

Defined in: src/entities/property.ts:191

Initial value used when initializing UI. See also defaultValue

Parameters
ParameterType
sstring
Returns

void

Initial value used when initializing UI. See also defaultValue

Inherited from

Property.initialValue


inputType

Get Signature

get inputType(): string

Defined in: src/entities/property.ts:178

Input type. See also InputType

Returns

string

Set Signature

set inputType(s): void

Defined in: src/entities/property.ts:179

Property input type

Parameters
ParameterType
sstring
Returns

void

Property input type

Inherited from

Property.inputType


isVectorizable

Get Signature

get isVectorizable(): boolean

Defined in: src/entities/property.ts:244

Returns

boolean

Inherited from

Property.isVectorizable


max

Get Signature

get max(): number

Defined in: src/entities/property.ts:218

Maximum value. Used when constructing UI (sliders), validating, etc.

Returns

number

Set Signature

set max(s): void

Defined in: src/entities/property.ts:219

Maximum value. Applicable to numerical properties only

Parameters
ParameterType
snumber
Returns

void

Maximum value. Applicable to numerical properties only

Inherited from

Property.max


min

Get Signature

get min(): number

Defined in: src/entities/property.ts:214

Minimum value. Used when constructing UI (sliders), validating, etc.

Returns

number

Set Signature

set min(s): void

Defined in: src/entities/property.ts:215

Minimum value. Applicable to numerical properties only

Parameters
ParameterType
snumber
Returns

void

Minimum value. Applicable to numerical properties only

Inherited from

Property.min


name

Get Signature

get name(): string

Defined in: src/entities/property.ts:142

Property name

Returns

string

Set Signature

set name(s): void

Defined in: src/entities/property.ts:143

Property name

Parameters
ParameterType
sstring
Returns

void

Property name

Inherited from

Property.name


nullable

Get Signature

get nullable(): boolean

Defined in: src/entities/property.ts:186

Nullable

Returns

boolean

Set Signature

set nullable(s): void

Defined in: src/entities/property.ts:187

Whether an empty value is allowed. This is used by validators.

Parameters
ParameterType
sboolean
Returns

void

Whether an empty value is allowed. This is used by validators.

Inherited from

Property.nullable


propertySubType

Get Signature

get propertySubType(): TYPE

Defined in: src/entities/property.ts:167

Property subtype

Returns

TYPE

Inherited from

Property.propertySubType


propertyType

Get Signature

get propertyType(): TYPE

Defined in: src/entities/property.ts:163

Property type. Same as type

Returns

TYPE

Set Signature

set propertyType(s): void

Defined in: src/entities/property.ts:164

Parameters
ParameterType
sTYPE
Returns

void

Inherited from

Property.propertyType


semType

Get Signature

get semType(): string

Defined in: src/entities/property.ts:174

Semantic type

Returns

string

Set Signature

set semType(s): void

Defined in: src/entities/property.ts:175

Semantic type

Parameters
ParameterType
sstring
Returns

void

Semantic type

Inherited from

Property.semType


set

Get Signature

get set(): PropertySetter

Defined in: src/entities/property.ts:138

Property setter

Returns

PropertySetter

Set Signature

set set(x): void

Defined in: src/entities/property.ts:139

Parameters
ParameterType
xPropertySetter
Returns

void

Inherited from

Property.set


showPlusMinus

Get Signature

get showPlusMinus(): boolean

Defined in: src/entities/property.ts:230

Whether a plus/minus clicker appears next to the number input. Applies to numerical columns only.

Returns

boolean

Set Signature

set showPlusMinus(s): void

Defined in: src/entities/property.ts:231

Whether a plus/minus clicker appears next to the number input. Applies to numerical columns only.

Parameters
ParameterType
sboolean
Returns

void

Whether a plus/minus clicker appears next to the number input. Applies to numerical columns only.

Inherited from

Property.showPlusMinus


showSlider

Get Signature

get showSlider(): boolean

Defined in: src/entities/property.ts:226

Whether a slider appears next to the number input. Applies to numerical columns only.

Returns

boolean

Set Signature

set showSlider(s): void

Defined in: src/entities/property.ts:227

Whether a slider appears next to the number input. Applies to numerical columns only.

Parameters
ParameterType
sboolean
Returns

void

Whether a slider appears next to the number input. Applies to numerical columns only.

Inherited from

Property.showSlider


step

Get Signature

get step(): number

Defined in: src/entities/property.ts:222

Step to be used in a slider. Only applies to numerical properties.

Returns

number

Set Signature

set step(s): void

Defined in: src/entities/property.ts:223

Step to be used in a slider. Only applies to numerical properties.

Parameters
ParameterType
snumber
Returns

void

Step to be used in a slider. Only applies to numerical properties.

Inherited from

Property.step


type

Get Signature

get type(): TYPE

Defined in: src/entities/property.ts:159

Property type. Same as propertyType

Returns

TYPE

Set Signature

set type(s): void

Defined in: src/entities/property.ts:160

Property data type. See TYPE.

Parameters
ParameterType
sTYPE
Returns

void

Property data type. See TYPE.

Inherited from

Property.type


units

Get Signature

get units(): string

Defined in: src/entities/property.ts:202

Units of measurement.

Returns

string

Set Signature

set units(s): void

Defined in: src/entities/property.ts:203

Units of measurement. See also: [postfix]

Parameters
ParameterType
sstring
Returns

void

Units of measurement. See also: [postfix]

Inherited from

Property.units


userEditable

Get Signature

get userEditable(): boolean

Defined in: src/entities/property.ts:210

Whether a user can edit this property from the UI.

Returns

boolean

Set Signature

set userEditable(s): void

Defined in: src/entities/property.ts:211

Whether the property should be editable via the UI

Parameters
ParameterType
sboolean
Returns

void

Whether the property should be editable via the UI

Inherited from

Property.userEditable


validators

Get Signature

get validators(): string[]

Defined in: src/entities/property.ts:241

Validation conditions to be checked when editing the property. See also PropertyValidator.

Returns

string[]

Set Signature

set validators(x): void

Defined in: src/entities/property.ts:242

List of validators. It can include [NAMED_VALIDATORS] as well as any pre-defined function names. Signature: validator(x: DG.Type): string | null. [null] indicates that the value is valid, [string] describes a validation error.

Parameters
ParameterType
xstring[]
Returns

void

List of validators. It can include [NAMED_VALIDATORS] as well as any pre-defined function names. Signature: validator(x: DG.Type): string | null. [null] indicates that the value is valid, [string] describes a validation error.

Inherited from

Property.validators


vectorName

Get Signature

get vectorName(): string

Defined in: src/entities/property.ts:246

Returns

string

Inherited from

Property.vectorName

Methods

fromOptions()

fromOptions(opt?): Property

Defined in: src/entities/property.ts:254

Applies the specified options

Parameters

ParameterType
opt?IProperty

Returns

Property

Inherited from

Property.fromOptions


bool()

static bool(name, getter, setter, defaultValue): Property

Defined in: src/entities/property.ts:284

Creates a bool property

Parameters

ParameterType
namestring
getterPropertyGetter
setterPropertySetter
defaultValueany

Returns

Property

Inherited from

Property.bool


create()

static create(name, type): EntityProperty

Defined in: src/entities/property.ts:352

Creates a property

Parameters

ParameterType
namestring
typestring

Returns

EntityProperty

Overrides

Property.create


dateTime()

static dateTime(name, getter, setter, defaultValue): Property

Defined in: src/entities/property.ts:289

Creates a datetime property

Parameters

ParameterType
namestring
getterPropertyGetter
setterPropertySetter
defaultValueany

Returns

Property

Inherited from

Property.dateTime


float()

static float(name, getter, setter, defaultValue): Property

Defined in: src/entities/property.ts:274

Creates a float property

Parameters

ParameterType
namestring
getterPropertyGetter
setterPropertySetter
defaultValueany

Returns

Property

Inherited from

Property.float


fromOptions()

static fromOptions(options): Property

Defined in: src/entities/property.ts:307

Parameters

ParameterType
optionsIProperty

Returns

Property

Inherited from

Property.fromOptions


int()

static int(name, getter, setter, defaultValue): Property

Defined in: src/entities/property.ts:269

Creates an integer property

Parameters

ParameterType
namestring
getterPropertyGetter
setterPropertySetter
defaultValueany

Returns

Property

Inherited from

Property.int


js()

static js(name, type, options?): Property

Defined in: src/entities/property.ts:294

Creates property for the JavaScript objects with the corresponding property name

Parameters

ParameterType
namestring
typeTYPE
options?IProperty

Returns

Property

Inherited from

Property.js


jsBool()

static jsBool(name, options?): Property

Defined in: src/entities/property.ts:302

Parameters

ParameterType
namestring
options?IProperty

Returns

Property

Inherited from

Property.jsBool


jsDateTime()

static jsDateTime(name, options?): Property

Defined in: src/entities/property.ts:305

Parameters

ParameterType
namestring
options?IProperty

Returns

Property

Inherited from

Property.jsDateTime


jsFloat()

static jsFloat(name, options?): Property

Defined in: src/entities/property.ts:303

Parameters

ParameterType
namestring
options?IProperty

Returns

Property

Inherited from

Property.jsFloat


jsInt()

static jsInt(name, options?): Property

Defined in: src/entities/property.ts:301

Parameters

ParameterType
namestring
options?IProperty

Returns

Property

Inherited from

Property.jsInt


jsString()

static jsString(name, options?): Property

Defined in: src/entities/property.ts:304

Parameters

ParameterType
namestring
options?IProperty

Returns

Property

Inherited from

Property.jsString


registerAttachedProperty()

static registerAttachedProperty(typeName, property): void

Defined in: src/entities/property.ts:312

Registers the attached (dynamic) property for the specified type. It is editable via the context panel, and gets saved into the view layout as well. Property getter/setter typically uses Widget's "temp" property for storing the value.

Parameters

ParameterType
typeNamestring
propertyProperty

Returns

void

Inherited from

Property.registerAttachedProperty


string()

static string(name, getter, setter, defaultValue): Property

Defined in: src/entities/property.ts:279

Creates a string property

Parameters

ParameterType
namestring
getterPropertyGetter
setterPropertySetter
defaultValueany

Returns

Property

Inherited from

Property.string