IOleInPlaceSiteEx::RequestUIActivate メソッド (ocidl.h)
オブジェクトが UI アクティブ状態に入りようとしていることをコンテナーに通知します。
構文
HRESULT RequestUIActivate();
戻り値
オブジェクトがアクティブ化プロセスを続行し、 IOleInPlaceSite::OnUIActivate を呼び出すことができる場合、このメソッドはS_OKを返します。 その他の可能な戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
オブジェクトは UI アクティブ状態に入ることができません。 オブジェクトは IOleInPlaceSite::OnUIDeactivate を呼び出して、コンテナーがフォーカスを復元するために必要な処理を実行できるようにする必要があります。 |
|
操作が失敗しました。 |
注釈
オブジェクトは、このメソッドを呼び出して、UI アクティブ状態に入ることができるかどうかを判断し、この遷移を行うしようとしていることをコンテナーに通知します。 コンテナーは、この要求を拒否するS_FALSEを返すことができます。たとえば、エンド ユーザーが操作を取り消した場合や、現在アクティブなオブジェクトがアクティブな状態を放棄しない場合などです。
オブジェクトが IOleInPlaceSiteEx::RequestUIActivate を呼び出さない場合、コンテナーはデータ検証を処理し、 IOleInPlaceSite::OnUIActivate から Enter イベントと Exit イベントを発生させます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ocidl.h |