Home	Products	Downloads	Ordering	Feedback	Bug Reports	Links
	Welcome to Dolphin Software Solutions - http://www.dolphinsoftware.bc.ca

TDssNavigator Component for Delphi

• Download TDssNavigator for BDE (D1-4)
• Download TDssNavigator for Advantage TDataset for Delphi (D3/D4 only)
• Download TDssNavigator for DBISAM Database Engine (D3/D4 only)

TDssNavigator is a replacement for Delphi's DbNavigator component. TDssNavigator was born out of the need for a navigator-style component whose buttons could be understood immediately. Novice users especially have a difficult time understanding what each glyph means on the default navigator component.

TDssNavigator adds numerous features, such as the ability for all default functionality to be over-ridden via event handlers. You can determine which buttons should be displayed to the user via the VisibleButtons property.

All button captions can be changed using the Captions property. This allows you to change all or selected button captions only.

You can also have the screen change colour to signify Edit and View modes. All colour changes are handled via the ColorViewMode and ColorEditMode properties.

There are two run-time properties available to determine the current state of the database. The first, EditMode, returns true if the dataset is in Insert or Edit mode, false if in Browse mode. The second, NewRec, returns true if the dataset is in Insert mode, false if in Edit mode. These allow you to do special processing in the AfterCreate or AfterEdit event handlers, or any other place you may require knowing what state the dataset is currently in.

Properties:

• property DataSource: TDataSource;
• property VisibleButtons: TDssBtnSet read FVisibleButtons write SetVisible
  default [nbCreate, nbModify, nbDelete, nbFind, nbSort, nbTop, nbPrior, nbNext, nbBottom, nbOptions, nbList, nbHelp, nbExit];
• property Align: TAlign;
• property Enabled: Boolean;
• property Captions: TStrings;
• property Hints: TStrings;
• property ColorViewMode: TColor;
• property ColorEditMode: TColor;

Events:

• OnClick
• OnBeforeCreate
• OnBeforeModify
• OnBeforeDelete
• OnBeforeSave
• OnBeforeCancel
• OnAfterCreate
• OnAfterModify
• OnAfterDelete
• OnAfterSave
• OnAfterCancel
• OnFindClick
• OnSortClick
• OnOptionsClick
• OnListClick
• OnAuditClick
• OnHelpClick
• OnExitClick
• OnEnter
• OnExit
• OnResize

The following is a list of all available buttons and their default functionality, if any:

nbCreate	Calls the dataset's Insert method and changes the screen colors to ColorEditMode. The OnBeforeCreate event handler is called before the Insert method is executed. The OnAfterCreate event handler is called after the Insert method is executed.
nbModify	Calls the dataset's Edit method and changes the screen colors to ColorEditMode. The OnBeforeModify event handler is called before the Edit method is executed. The OnAfterModify event handler is called after the Insert method is executed.
nbSave	Calls the dataset's Post method and changes the screen colors to ColorViewMode. The OnBeforeSave event handler is called before the Post method is executed. The OnAfterSave event handler is called after the Insert method is executed.
nbCancel	Calls the dataset's Cancel method and changes the screen colors to ColorViewMode. The OnBeforeCancel event handler is called before the Cancel method is executed. The OnAfterCancel event handler is called after the Insert method is executed.
nbDelete	Calls the dataset's Delete method. A dialog displays before the Delete call to confirm that the user really wants to remove the current record.
nbFind	Displays the built-in Search Dialog. This dialog displays a list of all indexes for the current table with an edit box for the user to input the search criteria. When the user clicks the OK button, this dialog calls the dataset's FindNearest method.
nbSort	Displays the built-in Sort Dialog. This dialog displays a list of all indexes for the current table. When the user clicks the OK button, this dialog sets the dataset's IndexName property to the name of the index selected.
nbTop	Positions the dataset on the First record of the current sort order.
nbPrior	Positions the dataset on the Prior record of the current sort order.
nbNext	Positions the dataset on the Next record of the current sort order.
nbBottom	Positions the dataset on the Last record of the current sort order.
nbOptions	Can be used to display any optional screens you want to call from your form. If the OnOptionsClick event is not assigned, this button displays the message "Options Not Available".
nbList	Calls the TDssNavigator parent form's Print method. A dialog is displayed before printing to confirm that the user wants to print the current screen. After the call to the Print method a dialog displays telling the user that the screen was printed.
nbAudit	Can be used to display Audit information for the current record, if any. If the OnAuditClick event is not assigned, this button displays the message "Audit Not Available".
nbHelp	Can be used to call your program's Online Help system. If the OnHelpClick event is not assigned, this button displays the message "Help Not Available".
nbExit	Calls the TDssNavigator parent form's Close method. To add exit confirmation you should use the parent form's OnCloseQuery event.

TDssNavigator is freeware. You can use it in your projects as you see fit. Dolphin Software Solutions retains sole copyright and ownership of TDssNavigator.

• Download TDssNavigator for BDE (D1-4)
• Download TDssNavigator for Advantage TDataset for Delphi (D3/D4 only)
• Download TDssNavigator for DBISAM Database Engine (D3/D4 only)

If you would like the source code for TDssNavigator, please specify which database engine you are using, (BDE, DBISAM or Advantage) and send a cheque or money order (payable to Dolphin Software) for $15.00 US / $20.00 Canadian to:

Be sure to include your email address, as all source code will be sent via email.