ITextInputPanel::get_PreferredInPlaceDirection メソッド (peninputpanel.h)
[ITextInputPanel は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、 IInputPanelConfiguration を使用します。
]
テキスト入力フィールドに対するインプレース入力パネルの優先方向を取得または設定します。
このプロパティは読み取り/書き込み可能です。
構文
HRESULT get_PreferredInPlaceDirection(
InPlaceDirection *Direction
);
パラメーター
Direction
戻り値
なし
解説
アプリケーションでは、インプレース入力パネルが既定でテキスト入力フィールドの上または下に表示されるかどうかを指定できます。 これを行うには、アプリケーションで ITextInputPanel::P referredInPlaceDirection プロパティ を InPlaceDirection_Bottom または InPlaceDirection_Topに設定できます。 ITextInputPanel::P referredInPlaceDirection プロパティ は、入力パネルを画面上に保持するために必要な場合に、インプレース入力パネルによってアプリケーションによって設定された基本設定をオーバーライドするため、基本設定です。 システムの既定値は、可能な場合はテキスト フィールドの下にインプレース入力パネルを配置し、それ以外の場合は上に配置します。 PreferredInPlaceDirection を InPlaceDirection_Auto に設定すると、システムの既定値が復元されます。
例
次の C++ の例では、ITextInputPanel オブジェクト を作成し、g_pTipITextInputPanel::AttachedEditWindow プロパティを設定して InkEditIDC_EDIT3コントロールのウィンドウ ハンドルにアタッチします。 また、 ITextInputPanel::P referredInPlaceDirection プロパティを取得します。
if (SUCCEEDED(CoInitialize(NULL)))
{
if (SUCCEEDED(CoCreateInstance(CLSID_TextInputPanel, NULL, CLSCTX_INPROC, IID_ITextInputPanel, (VOID**)&g_pTip)))
{
if (SUCCEEDED(g_pTip->put_AttachedEditWindow(GetDlgItem(IDC_EDIT3)->m_hWnd)))
{
g_pTip->put_DefaultInPlaceState(InPlaceState_Expanded);
InPlaceState ips;
g_pTip->get_DefaultInPlaceState(&ips);
TRACE("DefaultInplaceState: %d\n", ips);
g_pTip->put_DefaultInputArea(PanelInputArea_CharacterPad);
PanelInputArea pia;
g_pTip->get_DefaultInputArea(&pia);
TRACE("DefaultInputArea: %d\n", pia);
g_pTip->put_ExpandPostInsertionCorrection(FALSE);
BOOL epic;
g_pTip->get_ExpandPostInsertionCorrection(&epic);
TRACE("ExpandPostInsertionCorrection: %d\n", epic);
g_pTip->put_InPlaceVisibleOnFocus(TRUE);
BOOL ipvof;
g_pTip->get_InPlaceVisibleOnFocus(&ipvof);
TRACE("InPlaceVisibleOnFocus: %d\n", ipvof);
g_pTip->put_PreferredInPlaceDirection(InPlaceDirection_Top);
InPlaceDirection direction;
g_pTip->get_PreferredInPlaceDirection(&direction);
TRACE("PreferredInPlaceDirection: %d\n", direction);
}
}
else
{
TRACE("Failed to create ITextInputPanel object.\n");
}
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | peninputpanel.h |
| [DLL] | Tiptsf.dll |