Control COOATTREDIT@1.1:CTRLStrList

This control is used to enter a string value that may be chosen from a dropdown box. The value may be stored as string (which is the value chosen from the dropdown box) or as integer (which is the position of the string in the dropdown box).
You may also use this control when the user should be supported by an autocomplete list. In that case an edit field is displayed together with a list box. The user can choose a value from the list box or enter his own text. In the list box only values will be displayed that match the data entered by the user. An autocomplete list is only supported for string properties.
A Fabasoft app.ducx Expression defined in parameter Values will have to provide the strings for the dropdown box. This expression has the following input/output values:

Example (Values Expression):

instance Expression GetStreetList {
  exprtext = expression {
    string ::value; // the value the user has entered, autocomplete only
    object ::attribute; // the attribute definition this control is used for
    boolean ::isvalue; // false if the control is used in search mode

    // set to true means that this expression has provide all possible
    //   entries for ::value, the expression will not be called again
    // set to false means that the values cannot be returned as a complete
    //   list since there are too many entries available. In that case
    //   the expression is subsequently called when the user continuous typing.
    boolean ::iscomplete = true;
    string @pattern = (::value) ? ::value + "%" : "%";
    string[] @streets = cooobj.GetStreets();
    return @streets[this like @pattern];
  }
}

The expression has to return a string array. The input/output values have to be passed in the global scope of the expression. The local scope contains the current object. You may use the temporary scope to define local variables.
The autocomplete list will show a maximum of 500 entries, even if the expression will return more entries.

Example:

row {
  CTRLStrList street {
    colspan = 4;
    controloptions = expression {
      dictionary dict = {
        Autocomplete: true,
        WildcardSearch: true,
        Values: #GetStreetList
      };
      return dict;
    }
  }
}