The requested page is not available for the requested platform. You are viewing the content for Default platform.

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 handler receives an argument of the ASPxClientTrackBarPositionChangingEventArgs type. 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 Gets or sets a value that specifies whether the event should be finally processed on the server side.

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.

Examples

The code sample below demonstrates how you can use the ASPxTrackBar control to specify a filter condition for the ASPxGridView control.

The ASPxClientTrackBar.PositionChanging event is handled 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 an end-user completing the change to the editor's value, and when the filter is applied.

The image below shows the result.

TrackBar_Grid

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);
};
See Also