ITextHost::TxActivate メソッド (textserv.h)

コントロールがアクティブであることをテキストホストに通知します。

構文

HRESULT TxActivate(
  LONG *plOldState
);

plOldState

型: LONG*

以前のアクティブ化の状態。

型: HRESULT

メソッドが成功した場合は、S_OKを返します。

メソッドが失敗した場合は、次の COM エラーコードを返します。 COM エラーコードの詳細については、「COM でのエラー処理」を参照してください。

リターンコード	説明
E_FAIL	現時点ではアクティブ化できません。

ホストがアクティブ化要求を拒否することは有効です。たとえば、コントロールが最小化され、非表示になる場合があります。

呼び出し元は、アクティブ化の失敗を適切に処理できる必要があります。

このメソッドが何回呼び出されても、コントロールを非アクティブ化するために必要な ITextHost::TxDeactivate 呼び出しは 1 つだけです。

この関数は 、plOldState で不透明なハンドルを返します。呼び出し元 (テキストサービスオブジェクト) は、このハンドルを保存し、後続の ITextHost::TxDeactivate の呼び出しで使用する必要があります。