Metode ITextInputPanel::get_PreferredInPlaceDirection (peninputpanel.h)

Artikel
03/01/2024

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

]

Mendapatkan atau mengatur arah pilihan Panel Input di tempat relatif terhadap bidang entri teks.

Properti ini bersifat baca/tulis.

Sintaks

HRESULT get_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. ITextInputPanel::P referredInPlaceDirection Property adalah preferensi karena Panel Input di tempat mengambil alih preferensi yang diatur oleh aplikasi jika perlu untuk menyimpan Panel Input di layar. Default sistem adalah memosisikan Panel Input di tempat di bawah bidang teks jika memungkinkan dan sebaliknya untuk memosisikannya 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, lalu 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