ddoPreferred

ddoPreferred(
g_filter
l_obj
)

 => b_obj / nil

Description

This function is a method of ddHiObjFilter that returns the preferred dd view object only for the View combo box. This return value is called after a linked cell ID is changed, and the value of the View combo box is not valid. The function is called with a list of dd object IDs and is expected to return a valid dd-view-id or nil.

Arguments

g_filter	A ddHiObjFilter object.
l_obj	A list of dd objects.

Values Returned

b_obj	A preferred dd view object.
nil	The first dd object in the specified list is accepted and listed in the View combo box.

Examples

Defines a sub-class of ddHiObjFilter. It returns the second object of a given list if available, otherwise returns the first object in the list.

(define trAcceptedViewNames (list "view1" "view2" ...)

(defclass trViewFilter (ddHiObjFilter) ())

(defmethod ddoPreferred ((self trViewFilter) (objs list))

  "preferred 2nd obj over the 1st one."

  (or (cadr objs) (car objs)))

Related Topics

Form and Field Functions

Return to top