ID
- What it does: Programmatic ID of the control.
- How to use it: Enter the text.
- Other notes: This must be unique. It is prefixed with btn.
Visible checkbox
- What it does: Determines whether the user can see the control.
- How to use it: Click the checkbox to check or uncheck.
Mode
- What it does: Determines whether the way the user opened the form affects the control. Options are All, New, and Update. All means that regardless of whether the user created new or opened existing, the control behaves the same. New is for creating new and Update is for opening existing.
- How to use it: Select from the drop down.
- Other notes: It defaults to All.
CSS Class
- What it does: Custom style sheet class that controls cell appearance.
- How to use it: Enter the text.
- Other notes: If left blank, the appearance is default. The class must be configured in the MVVM project style sheet in the .NET project.
Custom Attributes
- What it does: Custom attribute defined by the developer to be rendered on the HTML page.
- How to use it: Enter the text.
Text
- What it does: Text the user sees on the button; what the button is "called".
- How to use it: Enter the text.
- Other notes: This defaults to Search Criteria.
Method Type
- What it does: Method that executes when the user clicks the button.
- How to use it: This property is read-only.
- Other notes: This defaults to btnSearchCriteriaRequired_Click (Search Criteria Required). It does the following:
- Executes a count query based on criteria to determine if the results are too numerous to display (GetMaxSearch is false and count query exceeds Max Count).
- If step 1 checks out, adds the criteria the user entered to the form's main query and executes that query, plus any applicable sub queries.
- Uses the database table to load the collection to the lookup business object.
- Binds the collection to the results grid as search results.
This is the same as the Search method, except that the search will not execute unless the user has entered criteria. If the user has not entered criteria, the LOB application displays a message requesting some.
On Client Click
- What it does: Displays a message when the user clicks the button.
- How to use it: Select a message from the drop down.
Security Level
- What it does: Determines the security level of the button.
- How to use it: Select the desired security level.
- Other notes: This defaults to None. Other options are Read, Modify, New, Delete, or Execute.
Object Method
- What it does: Method that comes from the entity instead of the framework.
- How to use it: Enter the method.
- Other notes: The method has to be defined on the object before you can use it here.
Message ID
- What it does: Identifies the custom message to display when the user clicks the button.
- How to use it: Select from the drop down.
User Log Parameters
- What it does: Specifies the control values that need to be logged.
- How to use it: Click the magnifying glass icon and add the control(s) to the parameter field(s).
No Row Selected
- What it does: Message that displays when the user clicks the button without selecting any record.
- How to use it: Select from the drop down.
This post is part of the Lookup Form topic. Click here to open the Lookup Form Overview.