Find Component

Fnd_Find_AddCustom

Fnd_Find_AddCustom (label; method name{; position})

Legacy manual page 101

Parameters

ParameterTypeDescription
labelTextLabel to use
method nameTextMethod to call
positionLongintPosition in which to add the item (optional)

Description

The Fnd_Find_AddCustom routine lets the developer add a custom field to the search dialog. If the user selects the custom field label from the pop-up menu, Foundation will not attempt to search the database. Instead, the specified method will be called and will be passed these parameters:

Parameter Type Description label Text The label passed to the Fnd_Find_AddCustom method operator Text The operator code selected in the second pop-up menu search Text The text entered into the Find dialog button Number The selected radio button

Search Operator Options: SW = Starts With EW = Ends With C = Contains DC = Doesn't Contain > = Greater Than < = Less Than # = Doesn't Equal N> = Number greater than N< = Number less than N>= = Number is Greater or equal to N<= = Number is less than or equal to N= = Number equals N# = Number is not equal to T = True F = False

Radio button options: 1 = Search All 2 = Search Selection 3 = Add to Selection 4 = Omit from Selection

The method specified in this call must contain the following compiler declarations: C_TEXT($1;$2;$3) C_LONGINT($4)

Fnd_Find_AddField

Fnd_Find_AddField (->field{; position})

Parameter Type Description field Pointer Pointer to the field to add position Longint Position in which to add the item (optional)

The Fnd_Find_AddField routine lets the developer add a field to the search dialog. If position is not specified, the field is added to the end of the list. The field can be from the current table or a related table.

Fnd_Find_AddMultiField

Fnd_Find_AddMultiField (->array of field ptrs; label{; position})

Parameter Type Description array of field ptrs Pointer Pointer to an array of pointers label Text Label for the popup item position Longint Position in which to add the item (optional)

The Fnd_Find_AddMultiField routine lets the developer add one item for searching multiple fields to the search dialog. If position is not specified, this item is added to the end of the list. The array of field ptrs parameter must be an array of pointers, each of which points to a text or alpha field. After calling Fnd_Find_Display, you should reset the array to zero elements to release the memory used by the array. This routine is ideal for allowing users to search all of the names fields without having to specify a specific field each time. For example: ARRAY POINTER (aFields;3)

aFields{1}:=->[Employees]First Name
aFields{2}:=->[Employees]Middle Name
aFields{3}:=->[Employees]Last Name
Fnd_Find_AddMultiField (->aFields;"Name")

Fnd_Find_Display ARRAY POINTER (aFields;0)

Extracted source text
            Fnd_Find_AddCustom (label; method name{; position})

              Parameter                Type              Description
              label                    Text              Label to use
              method name              Text              Method to call
              position                 Longint           Position in which to add the item (optional)

            The Fnd_Find_AddCustom routine lets the developer add a custom field to the search dialog.
            If the user selects the custom field label from the pop-up menu, Foundation will not attempt to search the
            database. Instead, the specified method will be called and will be passed these parameters:

              Parameter                Type              Description
              label                    Text              The label passed to the Fnd_Find_AddCustom method
              operator                 Text              The operator code selected in the second pop-up menu
              search                   Text              The text entered into the Find dialog
              button                   Number            The selected radio button

            Search Operator Options:
              SW = Starts With
              EW = Ends With
              C = Contains
              DC = Doesn't Contain
                 > = Greater Than
                 < = Less Than
                 # = Doesn't Equal
                 N> = Number greater than
                 N< = Number less than
                 N>= = Number is Greater or equal to
                 N<= = Number is less than or equal to
                 N= = Number equals
                 N# = Number is not equal to
                 T = True
                 F = False

               Radio button options:
                 1 = Search All
                 2 = Search Selection
                 3 = Add to Selection
                 4 = Omit from Selection

               The method specified in this call must contain the following compiler declarations:
                  C_TEXT($1;$2;$3)
                  C_LONGINT($4)

   Fnd_Find_AddField
               Fnd_Find_AddField (->field{; position})

                 Parameter                        Type        Description
                 field                            Pointer     Pointer to the field to add
                 position                         Longint     Position in which to add the item (optional)

               The Fnd_Find_AddField routine lets the developer add a field to the search dialog. If position is not
               specified, the field is added to the end of the list.
               The field can be from the current table or a related table.

   Fnd_Find_AddMultiField
               Fnd_Find_AddMultiField (->array of field ptrs; label{; position})

                 Parameter                        Type        Description
                 array of field ptrs              Pointer     Pointer to an array of pointers
                 label                            Text        Label for the popup item
                 position                         Longint     Position in which to add the item (optional)

               The Fnd_Find_AddMultiField routine lets the developer add one item for searching multiple fields to
               the search dialog. If position is not specified, this item is added to the end of the list.
            The array of field ptrs parameter must be an array of pointers, each of which points to a text or alpha field.
            After calling Fnd_Find_Display, you should reset the array to zero elements to release the memory used
            by the array.
            This routine is ideal for allowing users to search all of the names fields without having to specify a specific
            field each time. For example:
              ARRAY POINTER (aFields;3)
              aFields{1}:=->[Employees]First Name
              aFields{2}:=->[Employees]Middle Name
              aFields{3}:=->[Employees]Last Name
              Fnd_Find_AddMultiField (->aFields;"Name")
              Fnd_Find_Display
              ARRAY POINTER (aFields;0)