IPenInputPanel::Refresh メソッド (peninputpanel.h)

  • [アーティクル]

[更新 は、Windows XP タブレット PC エディションでは使用できなくなりました。 代わりに、 テキスト入力パネル (TIP)を使用します。

タブレット PC 入力パネルの設定に基づいて PenInputPanel プロパティを更新して復元し、ペン入力パネルを自動的に配置し、ユーザー インターフェイスを既定のパネルに設定します。

構文

HRESULT Refresh();

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 正常終了しました。
E_UNEXPECTED
 予期しないパラメーターまたはプロパティの型。
E_FAIL
 未指定のエラーが発生しました。

解説

Refresh メソッドは、既定のパネルを復元します。 たとえば、 DefaultPanel プロパティが Keyboard に設定され、 CurrentPanel プロパティが Handwriting に設定されている場合、 Refresh メソッドはペン入力パネルを Keyboard に設定 します。 DefaultPanel プロパティが Default に設定されている場合、Refresh メソッドはペン入力パネルを変更しません。

Refresh メソッドは、ペン入力パネルをアタッチ先のコントロールに対して自動的に配置します。

Refresh メソッドは、入力パネルの設定を使用してペン入力パネルを更新します。 たとえば、 PenInputPanel オブジェクトを変更してから Refresh を呼び出して、入力パネルからコピーした設定に設定を復元できます。

PenInputPanel オブジェクトは、入力パネルの設定が変更されるたびに自動的に更新されます。

ペン入力パネルにフォーカスがないときに Refresh を呼び出すと、エラーが発生します。

メモ 通常、ペン入力パネルのアクティブ化中に上記のすべてが実行されるため、 Refresh を呼び出す必要はありません。 ただし、 AutoShow プロパティが FALSE に設定されている場合は、ペン入力パネルのアクティブ化を無効にすることができます。 そのため、 Refresh メソッドが必要です。
 

要件

要件 値
サポートされている最小のクライアント Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー peninputpanel.h
Library InkObj.dll

こちらもご覧ください

IPenInputPanel

Peninputpanel