TDecisionSource.GetState Method

Returns the state of a dimension.

Pascal

function GetState(iDim: Integer): TDimState;

C++

__fastcall TDimState GetState(int iDim);

Description

Call GetState to determine whether a specified dimension is open, closed, or drilled. The iDim parameter is the absolute index of the dimension, where 0 specifies the first active dimension in the decision cube, 1 specifies the second active dimension, and so on. GetState returns one of the following values:

Value	Meaning
dmClosed	The dimension is closed. None of its values appear in the decision control.
dmOpen	The dimension is open. All of its values appear in the decision control.
dmDrilled	The dimension is drilled. Only a single value (or a summary over all values) along the dimension appears in the decision control.
dmPaged	The dimension can only display a single value or summarize all values together.
dmNone	The dimension is not active.

Note: The state dmDrilled appears the same as dmPaged in a decision control. However, drilled dimensions can be changed to open or closed, while paged dimensions cannot change their state. Paged dimensions use considerably less memory than other types.