PivotGridControl.ExpandValueAsync(Boolean, Object[], AsyncCompletedHandler) Method

Expands the specified column or row asynchronously. Allows you to specify custom actions to be performed after this operation is completed.

Namespace: DevExpress.Xpf.PivotGrid

Assembly: DevExpress.Xpf.PivotGrid.v14.2.dll

Declaration

C#

public void ExpandValueAsync(
    bool isColumn,
    object[] values,
    AsyncCompletedHandler asyncCompleted
)

VB.NET

Public Sub ExpandValueAsync(
    isColumn As Boolean,
    values As Object(),
    asyncCompleted As AsyncCompletedHandler
)

Parameters

Name	Type	Description
isColumn	Boolean	true to expand a column; false to expand a row.
values	Object[]	An array of field values that identify the column/row to be expanded.
asyncCompleted	AsyncCompletedHandler	An AsyncCompletedHandler delegate referencing a method that should be executed after the operation is completed.

Remarks

The ExpandValueAsync method is asynchronous. It starts executing the related operation in a background thread, and immediately returns control. The primary UI thread is not blocked, allowing the application to continue responding to end-user actions. For more information about the asynchronous mode, see Asynchronous Mode.

Consider the following PivotGridControl:

To expand '1995' within "Aniseed Syrup", do the following:

C#

pivotGrid.ExpandValueAsync(true, 
    new object[] { "Aniseed Syrup", 1995 }, 
    delegate(AsyncOperationResult result) {
        // ...
    });

The image below shows the result:

To expand a column or row synchronously, use the PivotGridControl.ExpandValue method.

To collapse a column or row, use the PivotGridControl.CollapseValueAsync (asynchronous) or PivotGridControl.CollapseValue (synchronous) method.