IQuickActivate

コントロールとコンテナーが、コントロールの読み込み時のパフォーマンスのボトルネックを回避できるようにします。コントロールとそのコンテナーの間で行われる読み込み時または初期化時のハンドシェイクを、単一の呼び出しにまとめます。

コントロールをクイックアクティブ化します。

メソッドが成功した場合、戻り値は S_OK です。それ以外の場合は E_FAIL です。

コントロールが IQuickActivate をサポートしていない場合、コンテナーはコントロールを読み込む際に一定のハンドシェイク操作を行います。コンテナーはコントロール上の特定のインターフェイスを呼び出し、コントロールは今度はコンテナーのクライアントサイト上の特定のインターフェイスにコールバックします。まず、コンテナーはコントロールオブジェクトを作成し、QueryInterface を呼び出して必要なインターフェイスを問い合わせます。次に、コンテナーはコントロール上で IOleObject::SetClientSite を呼び出し、自身のクライアントサイトへのポインターを渡します。続いて、コントロールはこのサイト上で QueryInterface を呼び出し、追加で必要なインターフェイスへのポインターを取得します。

QuickActivate メソッドを使用すると、コンテナーは QACONTAINER 構造体へのポインターを渡します。この構造体には、コントロールが必要とするインターフェイスへのポインターと、コントロールが必要とする可能性のあるいくつかのアンビエントプロパティの値が含まれています。戻り時に、コントロールは QACONTROL 構造体へのポインターを渡します。この構造体には、コンテナーが必要とするコントロール自身のインターフェイスへのポインターと、追加の状態情報が含まれています。

IPersist*::Load および IPersist*::InitNew メソッドは、クイックアクティブ化が行われた後に呼び出す必要があります。コントロールは、クイックアクティブ化中にコンテナーのシンクへの接続を確立する必要があります。ただし、これらの接続は IPersist*::Load または IPersist*::InitNew が呼び出されるまで有効になりません。

コントロールのコンテンツ範囲を設定します。

メソッドが成功した場合、戻り値は S_OK です。それ以外の場合は E_FAIL です。

コントロールのコンテンツ範囲を取得します。

メソッドが成功した場合、戻り値は S_OK です。それ以外の場合は E_FAIL です。

SIZEL 構造体は Wtypes.h で次のように定義されています。

typedef struct tagSIZEL
    {
    LONG cx;
    LONG cy;
    } 	SIZEL;

typedef struct tagSIZEL *PSIZEL;

typedef struct tagSIZEL *LPSIZEL;