An image zoom navigator control.
The ASPxImageZoomNavigator is a data control that displays a set of thumbnails. Clicking (or hovering based on the ASPxImageZoomNavigator.ActiveItemChangeAction property value) a thumbnail opens a corresponding image in an associated ASPxImageZoom control (ASPxImageZoom.AssociatedImageZoomNavigatorID).
The number of thumbnails displayed in an ASPxImageZoomNavigator object is controlled by the ASPxImageZoomNavigator.VisibleItemCount property. The thumbnails can be ordered in a horizontal or vertical direction based on the ASPxImageZoomNavigator.Orientation property value.
Images displayed by the ASPxImageZoomNavigator control can be defined in the ASPxImageZoomNavigator.Items collection. Additionally, the control can be populated with item information taken from a data source that can be specified by using either of the following properties.
- ASPxDataWebControlBase.DataSource to programmatically supply a data object.
- ASPxDataWebControl.DataSourceID to define a declarative data source.
When the ASPxImageZoomNavigator control is bound to a data source, an ImageZoomNavigatorItem object is created automatically for every recognized data item. Individual item characteristics (such as text, image path, and thumbnail path) are obtained from the data fields (item attributes) of the corresponding data items. The ASPxImageZoomNavigator exposes its specific data-related properties, allowing you to specify which data source fields the item information should be retrieved from.
|ASPxImageZoomNavigator.ImageUrlField||Gets or sets the name of a data field (or an xml element's attribute) which provides items' image locations.|
|ASPxImageZoomNavigator.LargeImageUrlField||Gets or sets the name of a data field (or an xml element's attribute) which provides items' large image locations.|
|ASPxImageZoomNavigator.ThumbnailUrlField||Gets or sets the name of a data field (or an xml element's attribute) which provides items' thumbnail image locations.|
|ASPxImageZoomNavigator.ImageContentBytesField||Gets or sets the data source field which provides items' binary images.|
|ASPxImageZoomNavigator.ExpandWindowTextField||Gets or sets the name of a data field (or an xml element's attribute) which provides the items' expand window texts.|
|ASPxImageZoomNavigator.ZoomWindowTextField||Gets or sets the name of a data field (or an xml element's attribute) which provides items' zoom window texts.|
- The control's client-side equivalent is represented by the ASPxClientImageZoomNavigator object.
- On the client side, the client object can be accessed directly by the name specified by the ASPxImageSliderBase.ClientInstanceName property.
- The available client events can be accessed by using the ASPxImageZoomNavigator.ClientSideEvents property.
The control's client-side API is enabled if the ASPxImageSliderBase.ClientInstanceName property is defined or any client event is handled.