ASPxClientTrackBar.PositionChanging Event
Fires on the client side before a track bar position is changed and allows you to cancel the action.
Declaration
PositionChanging: ASPxClientEvent<ASPxClientTrackBarPositionChangingEventHandler<ASPxClientTrackBar>>
Event Data
The PositionChanging event's data class is ASPxClientTrackBarPositionChangingEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
cancel | Gets or sets a value indicating whether the action which raised the event should be canceled. |
currentPosition | Gets the current drag handle position. |
currentPositionEnd | Gets the current secondary drag handle position. |
currentPositionStart | Gets the current main drag handle position. |
newPosition | Gets a position where the drag handle is being moved. |
newPositionEnd | Gets a position where the secondary drag handle is being moved. |
newPositionStart | Gets a position where the main drag handle is being moved. |
processOnServer | Specifies whether or not to process the event on the server. Inherited from ASPxClientProcessingModeEventArgs. |
Remarks
Each time a drag handle position is going to be changed, the PositionChanging event occurs, allowing you to cancel the action. You can use the event parameter’s properties to identify the current and new handle positions.
If the TrackBarProperties.AllowRangeSelection property is set to false the current and new positions of the single drag handle can be determined via the currentPosition and newPosition properties.
If the AllowRangeSelection property is set to true a track bar displays two drag handles to support the value range selection. In this case, use the currentPositionStart and newPositionStart properties to get the main drag handle positions, and currentPositionEnd and newPositionEnd to get the secondary drag handle positions.
To cancel the operation, set the cancel property to true.
Example
The code sample below demonstrates how you can use the ASPxTrackBar control to specify a filter condition for the ASPxGridView control.
Handle the ASPxClientTrackBar.PositionChanging
event to update label content that displays the currently selected range. The ASPxClientTrackBar.PositionChanged event handler applies the specified filter to the grid by using the ASPxClientGridView.ApplyFilter method. Note that the ASPxTrackBar.ValueChangedDelay property specifies the time interval between when a user changes the editor’s value and when the filter is applied.
The image below shows the result.
function initLbRange() {
lbRange.SetText('$' + tbSale.GetPositionStart() + ',000 - $' + tbSale.GetPositionEnd() + ',000');
updateGrid();
};
function updateLbRange(s, e) {
lbRange.SetText('$' + e.newPositionStart + ',000 - $' + e.newPositionEnd + ',000');
};
function updateGrid() {
var filterCondition = "[Sale] > " + tbSale.GetPositionStart() * 1000
+ " AND [Sale] < " + tbSale.GetPositionEnd() * 1000;
grid.ApplyFilter(filterCondition);
};