Metode ITextInputPanel::p ut_PreferredInPlaceDirection (peninputpanel.h)

Artikel
03/01/2024

[ITextInputPanel tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan IInputPanelConfiguration.

]

Mendapatkan atau mengatur arah yang disukai dari Panel Input di tempat relatif terhadap bidang entri teks.

Properti ini bersifat baca/tulis.

Sintaks

HRESULT put_PreferredInPlaceDirection(
  InPlaceDirection Direction
);

Parameter

Direction

Mengembalikan nilai

Tidak ada

Keterangan

Aplikasi dapat menentukan apakah Panel Input di tempat default muncul di atas atau di bawah bidang entri teks. Untuk melakukan ini, aplikasi dapat mengatur Properti ITextInputPanel::P referredInPlaceDirection ke InPlaceDirection_Bottom atau InPlaceDirection_Top. Properti ITextInputPanel::P referredInPlaceDirection adalah preferensi karena Panel Input di tempat mengambil alih preferensi yang diatur oleh aplikasi jika diperlukan untuk menyimpan Panel Input di layar. Default sistem adalah memposisikan Panel Input di tempat di bawah bidang teks jika memungkinkan dan sebaliknya untuk memposisikannya di atas. Mengatur PreferredInPlaceDirection ke InPlaceDirection_Auto memulihkan default sistem.

Contoh

Contoh C++ ini membuat objek ITextInputPanel , g_pTip, dan melampirkannya ke handel jendela kontrol InkEdit , IDC_EDIT3, dengan mengatur properti Properti ITextInputPanel::AttachedEditWindow . Ini juga mengatur, kemudian mendapatkan Properti 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");
    }
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	peninputpanel.h
DLL	Tiptsf.dll

Lihat juga

Antarmuka ITextInputPanel

Bagikan melalui