PROPERTY_API int PROP_ask_composite_property | ( | tag_t | component, | |
const char * | composite_property, | |||
char ** | value | |||
) |
This call returns the Composite Property value for an Teamcenter Engineering component.
A Composite Property of an object defines a path to associated objects, with potentially multiple levels of indirection, resulting in an evaluation of a regular property on that or these associated object(s).
The syntax of a composite property is:
[objectTypeName.][referenceProperty[(criteriaProperty=criteriaValue[,criteriaProperty=criteriaValue]):][referenceProperty[(criteriaProperty=criteriaValue[,criteriaProperty=criteriaValue])]:]]property
where:
Restrictions:
Each intermediate step in the chain of properties references the next related object(s) in the path. Except for the last property, they must by specified by either a:
component | (I) Component for which the Composite Property is to be evaluated |
composite_property | (I) Composite Property to evaluate |
value | (OF) Returned property value |
PROPERTY_API int PROP_ask_composite_property_objs | ( | tag_t | component, | |
const char * | composite_property, | |||
int * | n_related_components, | |||
tag_t ** | related_components | |||
) |
This call returns an array of related Teamcenter Engineering components pointed to be a Composite Property value for a given Teamcenter Engineering component. See also PROP_ask_composite_property().
Restrictions:
Each intermediate step in the chain of properties references the next related object(s) in the path. Except for the last property, they must by specified by either a
component | (I) Component for which the Composite Property is to be evaluated |
composite_property | (I) Composite Property to evaluate |
n_related_components | (O) The number of returned components in related_components |
related_components | (OF) n_related_components The array of components pointed to by the Composite Property |
Asks descriptor for a property.
prop_tag | (I) The tag of the property |
prop_desc_tag | (O) The descriptor for the property |
Returns the property's LOV tag if there is a LOV attached to the property. A NULL value is returned otherwise. It will look all the way up the Type hierarchy for any LOV association.
prop_tag | (I) Tag of the property |
lov_tag | (O) Tag of the LOV |
PROPERTY_API int PROP_ask_max_num_elements | ( | tag_t | prop_tag, | |
int * | maxnumelem | |||
) |
Asks maximum number of elements for a property.
prop_tag | (I) The tag of the property |
maxnumelem | (O) The maximum number of elements for the property. Will be 1 for a single-valued property, -1 for a list property and a positive integer for an array property. |
PROPERTY_API int PROP_ask_max_string_length | ( | tag_t | prop_tag, | |
int * | maxstrlen | |||
) |
Asks maximum string length for a property. The property must be type PROP_string.
prop_tag | (I) The tag of the property |
maxstrlen | (O) The maximum string length of the property value |
PROPERTY_API int PROP_ask_name | ( | tag_t | prop_tag, | |
char ** | name | |||
) |
Asks name of a property.
prop_tag | (I) The tag of the property |
name | (OF) The name of the property |
PROPERTY_API int PROP_ask_num_elements | ( | tag_t | prop_tag, | |
int * | num_elem | |||
) |
Asks number of elements a property holds (i.e., how large is the list or array).
A single-valued property will always return 1. An array will return the size of the array. A list will return the current number of elements in the list, ranging from 0 to infinity.
prop_tag | (I) The tag of the property |
num_elem | (O) Number of elements the property holds |
Ask the type that the property defines.
prop_tag | (I) The tag of the property |
type_tag | (O) The tag of the type |
Asks for the object that this property describes.
prop_tag | (I) The tag of the property |
obj_tag | (O) The tag of the object the property describes |
PROPERTY_API int PROP_ask_property_by_name | ( | tag_t | object_tag, | |
const char * | prop_name, | |||
tag_t * | prop_tag | |||
) |
Asks an object for its property with the specified name.
object_tag | (I) The tag of the object |
prop_name | (I) The name of the property |
prop_tag | (O) The tag of the property |
PROPERTY_API int PROP_ask_property_type | ( | tag_t | prop_tag, | |
PROP_type_t * | proptype, | |||
char ** | proptype_n | |||
) |
Returns the property type of a property. Go to the property descriptor (PROPDESC) module for a description of the possible property types.
prop_tag | (I) The tag of the property |
proptype | (O) The property type of the property |
proptype_n | (OF) The name of the property type |
PROPERTY_API int PROP_ask_value_char | ( | tag_t | prop_tag, | |
char * | value | |||
) |
Asks value of a single-valued property.
This function uses PROP_ask_value_char_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (O) Actual value of the property |
PROPERTY_API int PROP_ask_value_char_at | ( | tag_t | prop_tag, | |
int | position, | |||
char * | value | |||
) |
Asks value of a multi-valued (i.e., list or array) property at a particular index position. The property can be single-valued if position = 0.
This function uses PROP_ask_value_char_at_msg if the property is multi-valued or PROP_ask_value_char_msg if the property is single-valued and position = 0. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (O) Actual value of the property at the specified index position |
PROPERTY_API int PROP_ask_value_chars | ( | tag_t | prop_tag, | |
int * | num, | |||
char ** | values | |||
) |
Asks one or more values of a property. The property can be single-valued or multi-valued (i.e., array or list).
This function uses PROP_ask_value_chars_msg if multi-valued and PROP_ask_value_char_msg if single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (O) Number of values asked |
values | (OF) num Actual values of the property. This must be a list or array of constant chars. If the property is an array, the number of values passed in must equal the size of the array. |
Asks value of a single-valued property.
This function uses PROP_ask_value_date_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (O) Actual value of the property |
Asks value of a multi-valued (i.e., list or array) property at a particular index position. The property can be single-valued if position = 0.
This function uses PROP_ask_value_date_at_msg if the property is multi-valued or PROP_ask_value_date_msg if the property is single-valued and position = 0. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (O) Actual value of the property at the specified index position |
Asks one or more values of a property. The property can be single-valued or multi-valued (i.e., array or list).
This function uses PROP_ask_value_dates_msg if multi-valued and PROP_ask_value_date_msg if single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (O) Number of values asked |
values | (OF) num Actual values of the property. This must be a list or array of constant chars. If the property is an array, the number of values passed in must equal the size of the array. |
PROPERTY_API int PROP_ask_value_double | ( | tag_t | prop_tag, | |
double * | value | |||
) |
Asks value of a single-valued property.
This function uses PROP_ask_value_double_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (O) Actual value of the property |
PROPERTY_API int PROP_ask_value_double_at | ( | tag_t | prop_tag, | |
int | position, | |||
double * | value | |||
) |
Asks value of a multi-valued (i.e., list or array) property at a particular index position. The property can be single-valued if position = 0.
This function uses PROP_ask_value_double_at_msg if the property is multi-valued or PROP_ask_value_double_msg if the property is single-valued and position = 0. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (O) Actual value of the property at the specified index position |
PROPERTY_API int PROP_ask_value_doubles | ( | tag_t | prop_tag, | |
int * | num, | |||
double ** | values | |||
) |
Asks one or more values of a property. The property can be single-valued or multi-valued (i.e., array or list).
This function uses PROP_ask_value_doubles_msg if multi-valued and PROP_ask_value_double_msg if single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (O) Number of values asked |
values | (OF) num Actual values of the property. This must be a list or array of constant chars. If the property is an array, the number of values passed in must equal the size of the array. |
PROPERTY_API int PROP_ask_value_int | ( | tag_t | prop_tag, | |
int * | value | |||
) |
Asks value of a single-valued property.
This function uses PROP_ask_value_int_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (O) Actual value of the property |
PROPERTY_API int PROP_ask_value_int_at | ( | tag_t | prop_tag, | |
int | position, | |||
int * | value | |||
) |
Asks value of a multi-valued (i.e., list or array) property at a particular index position. The property can be single-valued if position = 0.
This function uses PROP_ask_value_int_at_msg if the property is multi-valued or PROP_ask_value_int_msg if the property is single-valued and position = 0. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (O) Actual value of the property at the specified index position |
PROPERTY_API int PROP_ask_value_ints | ( | tag_t | prop_tag, | |
int * | num, | |||
int ** | values | |||
) |
Asks one or more values of a property. The property can be single-valued or multi-valued (i.e., array or list).
This function uses PROP_ask_value_ints_msg if multi-valued and PROP_ask_value_int_msg if single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (O) Number of values asked |
values | (OF) num Actual values of the property. This must be a list or array of constant chars. If the property is an array, the number of values passed in must equal the size of the array. |
Asks value of a single-valued property.
This function uses PROP_ask_value_logical_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (O) Actual value of the property |
Asks value of a multi-valued (i.e., list or array) property at a particular index position. The property can be single-valued if position = 0.
This function uses PROP_ask_value_logical_at_msg if the property is multi-valued or PROP_ask_value_logical_msg if the property is single-valued and position = 0. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (O) Actual value of the property at the specified index position |
Asks one or more values of a property. The property can be single-valued or multi-valued (i.e., array or list).
This function uses PROP_ask_value_logicals_msg if multi-valued and PROP_ask_value_logical_msg if single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (O) Number of values asked |
values | (OF) num Actual values of the property. This must be a list or array of constant chars. If the property is an array, the number of values passed in must equal the size of the array. |
PROPERTY_API int PROP_ask_value_string | ( | tag_t | prop_tag, | |
char ** | value | |||
) |
Asks value of a single-valued property.
This function uses PROP_ask_value_string_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (OF) Actual value of the property |
PROPERTY_API int PROP_ask_value_string_at | ( | tag_t | prop_tag, | |
int | position, | |||
char ** | value | |||
) |
Asks value of a multi-valued (i.e., list or array) property at a particular index position. The property can be single-valued if position = 0.
This function uses PROP_ask_value_string_at_msg if the property is multi-valued or PROP_ask_value_string_msg if the property is single-valued and position = 0. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (OF) Actual value of the property at the specified index position |
PROPERTY_API int PROP_ask_value_strings | ( | tag_t | prop_tag, | |
int * | num, | |||
char *** | values | |||
) |
Asks one or more values of a property. The property can be single-valued or multi-valued (i.e., array or list).
This function uses PROP_ask_value_strings_msg if multi-valued and PROP_ask_value_string_msg if single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (O) Number of values asked |
values | (OF) num Actual values of the property. This must be a list or array of constant chars. If the property is an array, the number of values passed in must equal the size of the array. |
Asks value of a single-valued property.
This function uses PROP_ask_value_tag_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (O) Actual value of the property |
Asks value of a multi-valued (i.e., list or array) property at a particular index position. The property can be single-valued if position = 0.
This function uses PROP_ask_value_tag_at_msg if the property is multi-valued or PROP_ask_value_tag_msg if the property is single-valued and position = 0. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (O) Actual value of the property at the specified index position |
Asks one or more values of a property. The property can be single-valued or multi-valued (i.e., array or list).
This function uses PROP_ask_value_tags_msg if multi-valued and PROP_ask_value_tag_msg if single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (O) Number of values asked |
values | (OF) num Actual values of the property. This must be a list or array of constant chars. If the property is an array, the number of values passed in must equal the size of the array. |
PROPERTY_API int PROP_ask_value_type | ( | tag_t | prop_tag, | |
PROP_value_type_t * | valtype, | |||
char ** | valtype_n | |||
) |
Returns the value type of a property. Go to the property descriptor (PROPDESC) module for a description of the possible value types.
prop_tag | (I) The tag of the property |
valtype | (O) The value type of the property |
valtype_n | (OF) The name of the value type |
Asks property if it is modifiable by the user who is accessing it.
This function uses the message PROP_is_modifiable_msg. To customize the behavior, register a method against this message name.
prop_tag | (I) The tag of the property |
mod_flag | (O) Indicates whether the property is modifiable (i.e., TRUE = modifiable, FALSE = not modifiable) |
PROPERTY_API int PROP_is_property_localizable | ( | tag_t | object_tag, | |
char * | prop_name, | |||
logical * | is_localizable | |||
) |
object_tag | (I) |
prop_name | (I) |
is_localizable | (O) |
PROPERTY_API int PROP_list_common_modifiable_properties | ( | int | object_count, | |
tag_t * | object_tags, | |||
int * | prop_count, | |||
char *** | prop_names | |||
) |
object_count | (I) |
object_tags | (I) |
prop_count | (O) |
prop_names | (OF) prop_count |
Gets a list of properties for a specified object.
object_tag | (I) The tag of the object |
num | (O) Number of properties found |
prop_tags | (OF) num The list of properties |
PROPERTY_API int PROP_set_value_char | ( | tag_t | prop_tag, | |
char | value | |||
) |
Sets value on a single-valued property.
This function uses PROP_set_value_char_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (I) Actual value being set on the property |
PROPERTY_API int PROP_set_value_char_at | ( | tag_t | prop_tag, | |
int | position, | |||
char | value | |||
) |
Sets value on a multi-valued (i.e., list or array) property at a specified index position.
This function uses PROP_set_value_char_at_msg. If the property is single-valued and the index position = 0, PROP_set_value_char_msg will be called instead. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (I) Actual value being set on the property |
PROPERTY_API int PROP_set_value_chars | ( | tag_t | prop_tag, | |
int | num, | |||
const char * | values | |||
) |
Sets one or more values on a property.
This function uses PROP_set_value_chars_msg if the property is multi-valued or PROP_set_value_char_msg if this property is single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (I) Number of values to be set |
values | (I) Actual values being set on the property. This must be a list or array of constant characters. If the property is an array, the number of values passed in must equal the size of the array. |
Sets value on a single-valued property.
This function uses PROP_set_value_date_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (I) Actual value being set on the property |
Sets value on a multi-valued (i.e., list or array) property at a specified index position.
This function uses PROP_set_value_date_at_msg. If the property is single-valued and the index position = 0, PROP_set_value_date_msg will be called instead. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (I) Actual value being set on the property |
Sets one or more values on a property.
This function uses PROP_set_value_dates_msg if the property is multi-valued or PROP_set_value_date_msg if this property is single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (I) Number of values to be set |
values | (I) Actual values being set on the property. This must be a list or array of constant characters. If the property is an array, the number of values passed in must equal the size of the array. |
PROPERTY_API int PROP_set_value_double | ( | tag_t | prop_tag, | |
double | value | |||
) |
Sets value on a single-valued property.
This function uses PROP_set_value_double_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (I) Actual value being set on the property |
PROPERTY_API int PROP_set_value_double_at | ( | tag_t | prop_tag, | |
int | position, | |||
double | value | |||
) |
Sets value on a multi-valued (i.e., list or array) property at a specified index position.
This function uses PROP_set_value_double_at_msg. If the property is single-valued and the index position = 0, PROP_set_value_double_msg will be called instead. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (I) Actual value being set on the property |
PROPERTY_API int PROP_set_value_doubles | ( | tag_t | prop_tag, | |
int | num, | |||
const double * | values | |||
) |
Sets one or more values on a property.
This function uses PROP_set_value_doubles_msg if the property is multi-valued or PROP_set_value_double_msg if this property is single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (I) Number of values to be set |
values | (I) Actual values being set on the property. This must be a list or array of constant characters. If the property is an array, the number of values passed in must equal the size of the array. |
PROPERTY_API int PROP_set_value_int | ( | tag_t | prop_tag, | |
int | value | |||
) |
Sets value on a single-valued property.
This function uses PROP_set_value_int_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (I) Actual value being set on the property |
PROPERTY_API int PROP_set_value_int_at | ( | tag_t | prop_tag, | |
int | position, | |||
int | value | |||
) |
Sets value on a multi-valued (i.e., list or array) property at a specified index position.
This function uses PROP_set_value_int_at_msg. If the property is single-valued and the index position = 0, PROP_set_value_int_msg will be called instead. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (I) Actual value being set on the property |
PROPERTY_API int PROP_set_value_ints | ( | tag_t | prop_tag, | |
int | num, | |||
const int * | values | |||
) |
Sets one or more values on a property.
This function uses PROP_set_value_ints_msg if the property is multi-valued or PROP_set_value_int_msg if this property is single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (I) Number of values to be set |
values | (I) Actual values being set on the property. This must be a list or array of constant characters. If the property is an array, the number of values passed in must equal the size of the array. |
Sets value on a single-valued property.
This function uses PROP_set_value_logical_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (I) Actual value being set on the property |
Sets value on a multi-valued (i.e., list or array) property at a specified index position.
This function uses PROP_set_value_logical_at_msg. If the property is single-valued and the index position = 0, PROP_set_value_logical_msg will be called instead. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (I) Actual value being set on the property |
Sets one or more values on a property.
This function uses PROP_set_value_logicals_msg if the property is multi-valued or PROP_set_value_logical_msg if this property is single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (I) Number of values to be set |
values | (I) Actual values being set on the property. This must be a list or array of constant characters. If the property is an array, the number of values passed in must equal the size of the array. |
PROPERTY_API int PROP_set_value_string | ( | tag_t | prop_tag, | |
const char * | value | |||
) |
Sets value on a single-valued property.
This function uses PROP_set_value_string_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (I) Actual value being set on the property |
PROPERTY_API int PROP_set_value_string_at | ( | tag_t | prop_tag, | |
int | position, | |||
const char * | value | |||
) |
Sets value on a multi-valued (i.e., list or array) property at a specified index position.
This function uses PROP_set_value_string_at_msg. If the property is single-valued and the index position = 0, PROP_set_value_string_msg will be called instead. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (I) Actual value being set on the property |
PROPERTY_API int PROP_set_value_strings | ( | tag_t | prop_tag, | |
int | num, | |||
char ** | values | |||
) |
Sets one or more values on a property.
This function uses PROP_set_value_strings_msg if the property is multi-valued or PROP_set_value_string_msg if this property is single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (I) Number of values to be set |
values | (I) num Actual values being set on the property. This must be a list or array of constant characters. If the property is an array, the number of values passed in must equal the size of the array. |
Sets value on a single-valued property.
This function uses PROP_set_value_tag_msg. To customize the behavior of this function, register a method against this message name.
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (I) Actual value being set on the property |
Sets value on a multi-valued (i.e., list or array) property at a specified index position.
This function uses PROP_set_value_tag_at_msg. If the property is single-valued and the index position = 0, PROP_set_value_tag_msg will be called instead. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
position | (I) The position of the specified property in an array or list. The first position is 0. For example, if the property is an array of size 3 and the third value in the array is to be modified, then position = 2. |
value | (I) Actual value being set on the property |
Sets one or more values on a property.
This function uses PROP_set_value_tags_msg if the property is multi-valued or PROP_set_value_tag_msg if this property is single-valued. To customize the behavior of this function, register a method against one of these messages.
prop_tag | (I) Unique identifier (tag) of the property instance |
num | (I) Number of values to be set |
values | (I) Actual values being set on the property. This must be a list or array of constant characters. If the property is an array, the number of values passed in must equal the size of the array. |
PROPERTY_API int PROP_UIF_ask_name | ( | tag_t | prop_tag, | |
char ** | disp_name | |||
) |
Asks display name of a property.
prop_tag | (I) The tag of the property |
disp_name | (OF) The display name of the property |
PROPERTY_API int PROP_UIF_ask_property_by_name | ( | tag_t | object_tag, | |
const char * | disp_name, | |||
tag_t * | prop_tag | |||
) |
Asks an object for its property with the specified display name.
object_tag | (I) The tag of the object |
disp_name | (I) The display name of the property |
prop_tag | (O) The tag of the property |
PROPERTY_API int PROP_UIF_ask_value | ( | tag_t | prop_tag, | |
char ** | d_value | |||
) |
Asks the display value of a property. Regardless of what type of property is asked, this value will be returned as an MEM_alloc'd string.
This function uses PROP_UIF_ask_value_msg. To customize the behavior of this function, register a property method, pre-action or post-action against this message name.
A default method is registered against PROP_UIF_ask_value_msg. The default behavior is as follows:
prop_tag | (I) Unique identifier (tag) of the property instance |
d_value | (OF) The display value of the property |
Asks display name of a property.
prop_tag | (I) The tag of the property |
is_display | (O) Indicates whether property is displayable (i.e., TRUE=displayable, FALSE=not displayable) |
prop_tag | (I) |
is_enabled | (O) |
PROPERTY_API int PROP_UIF_list_displayable_properties | ( | tag_t | object_tag, | |
int * | num, | |||
tag_t ** | prop_tags | |||
) |
object_tag | (I) |
num | (O) |
prop_tags | (OF) num |
PROPERTY_API int PROP_UIF_set_value | ( | tag_t | prop_tag, | |
const char * | value | |||
) |
Sets the value of a property using a display value as input. This function will work for any property type, accepts string values as input, then calls the appropriate PROP_set_value_<type>s command.
This function uses PROP_UIF_set_value_msg. To customize the behavior of this function, register a property method, pre-action, or post-action against this message name.
A default method is registered against PROP_UIF_set_value_msg. The default behavior is as follows:
prop_tag | (I) Unique identifier (tag) of the property instance |
value | (I) The display value used to set the new value of the property |