SetValueListItemExpression Method

Sets the expression for searching the value list items.

Visual Basic
Public Sub SetValueListItemExpression( _ ByVal PseudoPropertyDef As MFValueListItemPropertyDef, _ ByVal PCBehavior As MFParentChildBehavior, _ Optional ByVal DataFunctionCall As DataFunctionCall = 0 _ )

Visual Basic

Public Sub SetValueListItemExpression( _
   ByVal PseudoPropertyDef As MFValueListItemPropertyDef, _
   ByVal PCBehavior As MFParentChildBehavior, _
   Optional ByVal DataFunctionCall As DataFunctionCall = 0 _
)

PseudoPropertyDef

Value	Description
MFValueListItemPropertyDefDeleted	Deleted status of the value list item.
MFValueListItemPropertyDefExtID	External ID (display ID) of the value list item.
MFValueListItemPropertyDefID	Value list item ID.
MFValueListItemPropertyDefName	Value list item name.
MFValueListItemPropertyDefObjectType	Object type of the value list item.
MFValueListItemPropertyDefOwner	Owner of the value list item.
MFValueListItemPropertyDefParent	Parent of the value list item.

Identifies the evaluated feature of a value list item.

PCBehavior

Value	Description
MFParentChildBehaviorIncludeChildValues	Accepts matches to child values as well.
MFParentChildBehaviorIncludeParentValues	Accepts matches to parent values as well.
MFParentChildBehaviorNone	No special behavior.

DataFunctionCall

Defines an optional data function for modifying the expression result. The data function availability depends on the evaluated data type.

In scripting languages, a specific null value (e.g., Nothing in VBScript) should be used to indicate the default value.

The value list item expression is used for searching value list items. It is practical for resolving a single value list item for an item ID. See the SearchForValueListItemsEx method for more details.

The target value (the right-hand operand) is assigned to the TypedValue object encapsulated in the parent SearchCondition object. The expected type of this value depends on the selected pseudo-property value.

Right-Hand Operand Types for Evaluated Pseudo-Properties

Evaluated Pseudo-Property	Expected Typed Value Data Type	Remarks
MFValueListItemPropertyDefID	MFDatatypeLookup	ID as a lookup value.
MFValueListItemPropertyDefName	MFDatatypeText	Display name of the item.
MFValueListItemPropertyDefOwner	MFDatatypeLookup	ID of the owner item as a lookup value.
MFValueListItemPropertyDefParent	MFDatatypeInteger	ID of the parent item.
MFValueListItemPropertyDefDeleted	MFDatatypeBoolean	True or false.
MFValueListItemPropertyDefObjectType	MFDatatypeInteger	ID of the object type.
MFValueListItemPropertyDefExtID	MFDatatypeText	External ID as a text value.

Expression Object | Expression Members | SearchForValueListItemsEx Method