Skip to main content

IcxNavigator Interface

Implementing this interface allows controls to have their navigation managed by the TcxNavigator control.

Declaration

IcxNavigator = interface(IInterface)

Remarks

The TcxNavigator control displays a set of buttons that have no predefined functionality. This allows a developer to use it with any other control. For instance, you can implement navigation in a runtime created dataset. Another example can be using the navigator to move through pages of a tab control or modify the edit value of a date edit. This is possible by having actions performed by navigator buttons implemented by the target control. This is done by the target control implementing the IcxNavigator interface that declares methods that must implement the navigator’s functionality.

The navigator can be bound to a specific control by initializing its Control property. This property can be set to any object that implements the IcxNavigator interface.

The methods declared by the IcxNavigator interface can be divided into three categories.

The first includes methods that are called when a navigator control becomes bound to the control and when a navigator is disconnected. This is required since you need to notify the bound navigator controls of changes within the target control. For instance, if the selected tab of a tab control changes, the tab control must notify all bound navigator controls of the fact.

The navigator control must be able to query the target control to see whether specific actions can be currently performed. For instance, the navigator control must decide whether forward navigation can be performed, and if not the Next button becomes disabled. The updating of navigator controls is performed by means of the second group of methods which must be implemented to return Boolean values that indicate whether a particular action can be currently performed.

Inheritance

IInterface
IcxNavigator
See Also