COleControl::GetReadyState

Returns the readiness state of the control.

long GetReadyState( );

Return Value

The readiness state of the control, one of the following values:

• READYSTATE_UNINITIALIZED
  Default initialization state

• READYSTATE_LOADING
  Control is currently loading its properties

• READYSTATE_LOADED
  Control has been initialized

• READYSTATE_INTERACTIVE
  Control has enough data to be interactive but not all asynchronous data is yet loaded

• READYSTATE_COMPLETE
  Control has all its data

Remarks

Most simple controls never need to differentiate between LOADED and INTERACTIVE. However, controls that support data path properties may not be ready to be interactive until at least some data is received asynchronously. A control should attempt to become interactive as soon as possible.

Requirements

Header: afxctl.h

See Also

Concepts

COleControl Class

COleControl Members

Hierarchy Chart

COleControl::FireReadyStateChange

COleControl::InternalSetReadyState