The Morfik Navigator package contains a single widget (Navigator) that is a replacement of and an enhancement to the standard Morfik navigator that is available in both the footer and header of a form. This navigator widget can be placed anywhere on a form and has a number of different styles and ways to control the dataset.


package-view.png
package-down.png


A Quick Walkthrough

To use the Morfik Navigator package simply add the package to the project by utilizing the “Used Packages” command on the project ribbon (see Figure 1 Used Packages Command), or simply drag the package file onto the application main client area.


security-fig1.png
Figure 1: Used Packages Command


Once added a single widget will appear on the home ribbon when the form designer is active (see Figure 2 Widgets List). This widget can be placed on an application form and provide immediate functionality with minimal coding.


n2.png
Figure 2: Selecting a Widget

How to Use the Widget

After dropping a Navigator widget on a form, you can use the Setup Navigator dialog to configure the widget rather than the Properties panel (see Figure 3 Local Widget Menu). The Setup dialog is displayed in Figure 4 Navigator Settings and the settings are outlined in the table below.


n3.png
Figure 3: Local Widget Menu


n4.jpg
Figure 4: Navigator Settings


Property  Description 
Style  Selects the style of the buttons to be displayed in the Navigator widget. The choice of style does not affect either the Record Buttons or the Page Buttons. 
Button Selection  Select the buttons on the left of the list which will be displayed in the navigator by moving them to the right side of the list. Two special options, Record Buttons and Page Buttons are discussed below. 
Centre Buttons  If checked, the buttons will be centered within the widget. 
Show Icons  For Record and Page Buttons only, if checked round icons will be displayed in the widget otherwise numbers will be displayed. 
Show Ellipses  For Record and Page Buttons only, if checked and Show Icons is not checked, ellipses will be displayed if not enough room is available to display all numbers. Refer to discussion below. 
Max Record Count  For Record Buttons only, specifies the maximum number of buttons that will be displayed by the widget based upon the number of records. 
Max Page Count  For Page Buttons only, specifies the maximum number of buttons that will be displayed by the widget based upon the number of pages. 

Record Buttons

This feature is best used when the View Mode of a form is vmSingle.

When Show Icons is checked, Record Buttons are displayed as round icons, one for each record up to the maximum number of records allowed (Max Record Count). The button corresponding to a record can be clicked to bring that record into view.

When Show Icons is not checked, the number for each record will be displayed instead of icons and the count of numbers shown is around the number specified in Max Record Count. If Show Ellipses is checked, intermediate numbers will be replaced with ellipses if appropriate.


Sample 1

In figure 5 Record Buttons the View Mode is set to vmSingle and the following properties were used:


Property  Description 
Style  (Doesn’t matter) 
Button Selection … record buttons
Centre Buttons  Checked 
Show Icons  Checked 
Show Ellipses (Doesn’t matter)
Max Record Count
Max Page Count  (Doesn’t matter) 


n5.png
Figure 5: Record Buttons


Sample 2

In figure 6 Navigation Buttons, the View Mode is set to vmContinuous and Page Size is set to 2 and the following properties were used:


Property  Description 
Style  Square Transparent
Button Selection First Page, Previous Page, Next Page, Last Page
Centre Buttons  Unchecked
Show Icons  Unchecked
Show Ellipses (Doesn’t matter)
Max Record Count 5
Max Page Count  5


n6.png
Figure 6: Navigation Buttons


Sample 3

In figure 7 Show Icons Not Checked, the View Mode is set to vmContinuous and Page Size is set to 10 and the following properties were used:

Property  Description 
Style  (Doesn’t matter) 
Button Selection … Page Buttons
Centre Buttons  Checked 
Show Icons  UnChecked 
Show Ellipses Checked
Max Record Count 5
Max Page Count  5


n7.png
Figure 7: Show Icons Not Checked


See Also

Back to top