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

こちらもご覧ください

ITextInputPanel インターフェイス