GetFieldChoiceType
Description
Returns the choice list type for the given field.
The return value is a ChoiceType constant, either CLOSED_CHOICE or OPEN_CHOICE. If the return value is CLOSED_CHOICE, the valid values for the field are limited to those specified in the choice list. If the return value is OPEN_CHOICE, the user may select an item from the choice list or type in a new value.
Syntax
Perl
$entity->GetFieldChoiceType(field_name);
- Identifier
- Description
- entity
- An Entity object representing a user data record. Inside a hook, if you omit this part of the syntax, the Entity object corresponding to the current data record is assumed.
- field_name
- A String that identifies a valid field name of entity.
- Return value
- A Long indicating the type of the field. This value is one
of the
ChoiceType constants.
Example
Perl
# If the field must have a value from a closed choice list, assign
# the first value in the list to the field by default.
$choicetype = $entity->GetFieldChoiceType("field1");
if ($choicetype eq $CQPerlExt::CQ_CLOSED_CHOICE)
{
# Set the field to the first item in the choice list.
$fieldchoicelist = $entity->GetFieldChoiceList("field1");
$entity->SetFieldValue("field1",@$fieldchoicelist[0]);
}