Table of Contents

Built-in dialogs

Lime CRM comes with a number of built-in dialogs that can be used for solving common tasks when customzing the application. Showing a dialog typically involves code along the following lines:

Dim Dlg As New Lime.Dialog
 
Dlg.Property("SomeSpecificProperty") = "DialogSpecificConfiguration"
 
If Dlg.Show(DialogType) = vbOK Then
   ' User confirmed, continue with whatever
End If

Available dialog types are found in the DialogTypeEnum enumeration. Below the most common dialog types are shown together with a short code example demonstrating the capabilities of the dialog.

Search records (lkDialogSearchRecords)

This dialog can be used for searching for and picking records:

Properties

Name Required Type Description
Class Yes LDE.Class The type of records to search for.
SearchFilter No LDE.Filter Restricts the records the dialog can search in.
SearchView No LDE.View Specifies which fields to search in. This view can be overriden by the user through the advanced options. By default the dialog searches in the field “Description (System)” or the set of fields last used.
SingleSelect No Boolean If True only one record can be selected. Default value is False. (Note: When singleselect is disabled the multi-select behaves oddly and requires a scroll on the mouse wheel to update properly.)
DisableAdvanced No Boolean If True the advanced settings will be disabled. Default value is False.
AutoLoad No Boolean If True the search result is loaded before the dialog is displayed. It will also disable the search function and the advanced options. Use in combination with a search filter or when you know the result is limited in numbers. The default value is False.
Caption No String Dialog caption.
CloseButtonCaption No String Close button caption.
SearchResultCaption No String Text displayed just above the search result.
Pool LDE.Pool Output

Example

The following examples allows the user to pick one single person having last name “Smith” and upon return prints the full name of of the person in the immediate window.

Dim oDlg As New Lime.Dialog
Dim oFilter As New LDE.Filter
 
oFilter.AddCondition "lastname", lkOpEqual, "Smith"
 
oDlg.Property("Class") = Database.Classes.Item("person")
oDlg.Property("SearchFilter") = oFilter
oDlg.Property("Caption") = "Search for Mr. Smith"
oDlg.Property("CloseButtonCaption") = "Pick him"
oDlg.Property("SearchResultCaption") = "Select your favorite Mr. Smith."
oDlg.Property("AutoLoad") = True
oDlg.Property("SingleSelect") = True
oDlg.Property("DisableAdvanced") = True
 
If oDlg.show(lkDialogSearchRecords) = vbOK Then
  Dim oPersons As New LDE.Records
  Dim oRec As LDE.Record
  oPersons.Open Database.Classes.Item("person"), oDlg.Property("Pool"), "name"
 
  For Each oRec In oPersons
      Debug.Print oRec("name")
  Next
End If