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.XtraPivotGrid

Assembly: DevExpress.XtraPivotGrid.v19.1.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	A 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 PivotGrid control:

To expand the “Austria” column (within the “Alice Mutton” column), use the following code:

C#

pivotGridControl1.ExpandValueAsync(true, 
    new object[] {"Alice Mutton", "Austria"}, 
    delegate(AsyncOperationResult result) {
        // ...
    });

The result of this operation is shown below:

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.