idDC (LONG) - input

DC state identifier.

Identifies the DC state to be restored. The values with which this parameter may be passed are as follows:

• A negative value indicates the number of device contexts that must be popped OFF the stack to access the required DC. A -1 indicates that the most recently saved DC must be restored.

• When this parameter is passed as a positive value (>0) and a corresponding DC does not exist, an error is returned. The current DC is not modified.

• When passed as a negative value and there are insufficient entries on the stack, an error is raised. The current DC is not modified.

• When the value passed corresponds to a saved DC, all entries on the stack up to the one indicated are discarded. Any clip regions selected into the discarded DCs are destroyed.

• A value of 1 resets the DC stack. All entries are removed from the stack.

• A value of 0 raises an error and the DC is not modified.

---

[Back: GreRestoreDC Parameter - hdc]
[Next: GreRestoreDC Parameter - pInstance]