Top Method Summary
Options Name Purpose
EnsureAttributeExists (handle, character) Verifies that the named attribute exists in the temp-table and raises an exception when it does not
HANDLE FindAttribute (handle, character, logical) Looks up the attribute row for the given attribute label and returns the buffer handle positioned on the row
CHARACTER GetCharacterValue (handle, character) Returns the CharacterValue of the named attribute
DATETIME-TZ GetDateTimeTzValue (handle, character) Returns the DateTimeTzValue of the named attribute
DATETIME GetDateTimeValue (handle, character) Returns the DateTimeValue of the named attribute
DATE GetDateValue (handle, character) Returns the DateValue of the named attribute
DECIMAL GetDecimalValue (handle, character) Returns the DecimalValue of the named attribute
INT64 GetInt64Value (handle, character) Returns the Int64Value of the named attribute
INTEGER GetIntegerValue (handle, character) Returns the IntegerValue of the named attribute
LOGICAL GetLogicalValue (handle, character) Returns the LogicalValue of the named attribute
SetCharacterValue (handle, character, character) Sets the CharacterValue of the named attribute and clears the IsInherited flag
SetDateTimeTzValue (handle, character, datetime-tz) Sets the DateTimeTzValue of the named attribute and clears the IsInherited flag
SetDateTimeValue (handle, character, datetime) Sets the DateTimeValue of the named attribute and clears the IsInherited flag
SetDateValue (handle, character, date) Sets the DateValue of the named attribute and clears the IsInherited flag
SetDecimalValue (handle, character, decimal) Sets the DecimalValue of the named attribute and clears the IsInherited flag
SetInt64Value (handle, character, int64) Sets the Int64Value of the named attribute and clears the IsInherited flag
SetIntegerValue (handle, character, integer) Sets the IntegerValue of the named attribute and clears the IsInherited flag
SetLogicalValue (handle, character, logical) Sets the LogicalValue of the named attribute and clears the IsInherited flag


Method Detail
Top

EnsureAttributeExists (handle, character)

Purpose: Verifies that the named attribute exists in the temp-table and
raises an exception when it does not
Notes: Useful in Initialize to fail fast with a clear error before the
dialog is shown.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to verify
Top

HANDLE FindAttribute (handle, character, logical)

Purpose: Looks up the attribute row for the given attribute label and
returns the buffer handle positioned on the row
Notes: When plRequireRow is true and the row is missing, an exception
is raised. When false, the returned buffer is not available -
callers must check hBuffer:available before reading.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to look up
plRequireRow LOGICAL
Logical true to raise an exception when the row is missing
Returns HANDLE
A dynamic buffer positioned on the row (callers must delete it)
Top

CHARACTER GetCharacterValue (handle, character)

Purpose: Returns the CharacterValue of the named attribute
Notes: Returns the empty string when the attribute row does not exist
in the temp-table.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to look up
Returns CHARACTER
The CharacterValue field or empty string when not found
Top

DATETIME-TZ GetDateTimeTzValue (handle, character)

Purpose: Returns the DateTimeTzValue of the named attribute
Notes: Returns the Unknown Value (?) when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to look up
Returns DATETIME-TZ
The DateTimeTzValue field or ? when not found
Top

DATETIME GetDateTimeValue (handle, character)

Purpose: Returns the DateTimeValue of the named attribute
Notes: Returns the Unknown Value (?) when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to look up
Returns DATETIME
The DateTimeValue field or ? when not found
Top

DATE GetDateValue (handle, character)

Purpose: Returns the DateValue of the named attribute
Notes: Returns the Unknown Value (?) when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to look up
Returns DATE
The DateValue field or ? when not found
Top

DECIMAL GetDecimalValue (handle, character)

Purpose: Returns the DecimalValue of the named attribute
Notes: Returns 0 when the attribute row does not exist in the temp-table.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to look up
Returns DECIMAL
The DecimalValue field or 0 when not found
Top

INT64 GetInt64Value (handle, character)

Purpose: Returns the Int64Value of the named attribute
Notes: Returns 0 when the attribute row does not exist in the temp-table.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to look up
Returns INT64
The Int64Value field or 0 when not found
Top

INTEGER GetIntegerValue (handle, character)

Purpose: Returns the IntegerValue of the named attribute
Notes: Returns 0 when the attribute row does not exist in the temp-table.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to look up
Returns INTEGER
The IntegerValue field or 0 when not found
Top

LOGICAL GetLogicalValue (handle, character)

Purpose: Returns the LogicalValue of the named attribute
Notes: Returns false when the attribute row does not exist in the temp-table.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to look up
Returns LOGICAL
The LogicalValue field or false when not found
Top

SetCharacterValue (handle, character, character)

Purpose: Sets the CharacterValue of the named attribute and clears the
IsInherited flag
Notes: Raises an exception when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to update
pcValue CHARACTER
The new value
Top

SetDateTimeTzValue (handle, character, datetime-tz)

Purpose: Sets the DateTimeTzValue of the named attribute and clears the
IsInherited flag
Notes: Raises an exception when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to update
pdtzValue DATETIME-TZ
The new value
Top

SetDateTimeValue (handle, character, datetime)

Purpose: Sets the DateTimeValue of the named attribute and clears the
IsInherited flag
Notes: Raises an exception when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to update
pdtValue DATETIME
The new value
Top

SetDateValue (handle, character, date)

Purpose: Sets the DateValue of the named attribute and clears the
IsInherited flag
Notes: Raises an exception when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to update
pdaValue DATE
The new value
Top

SetDecimalValue (handle, character, decimal)

Purpose: Sets the DecimalValue of the named attribute and clears the
IsInherited flag
Notes: Raises an exception when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to update
pdeValue DECIMAL
The new value
Top

SetInt64Value (handle, character, int64)

Purpose: Sets the Int64Value of the named attribute and clears the
IsInherited flag
Notes: Raises an exception when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to update
piValue INT64
The new value
Top

SetIntegerValue (handle, character, integer)

Purpose: Sets the IntegerValue of the named attribute and clears the
IsInherited flag
Notes: Raises an exception when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to update
piValue INTEGER
The new value
Top

SetLogicalValue (handle, character, logical)

Purpose: Sets the LogicalValue of the named attribute and clears the
IsInherited flag
Notes: Raises an exception when the attribute row does not exist.

Parameters:
phBuffer HANDLE
The handle of a buffer for the eDesignAttributeValue temp-table
pcAttributeLabel CHARACTER
The attribute label to update
plValue LOGICAL
The new value


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       01.06.2026 09:20:47