Metode ITextInputPanel::p ut_InPlaceVisibleOnFocus (peninputpanel.h)

Artikel
03/04/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 menetapkan nilai yang menunjukkan apakah Panel Input PC Tablet ditampilkan secara otomatis ketika jendela tempat terpasang mendapatkan fokus.

Properti ini bersifat baca/tulis.

Sintaks

HRESULT put_InPlaceVisibleOnFocus(
  BOOL Visible
);

Parameter

Visible

Mengembalikan nilai

Tidak ada

Keterangan

Jika Properti ITextInputPanel::InPlaceVisibleOnFocus diatur ke TRUE untuk kontrol, maka ketika kontrol mendapatkan fokus, Panel Input PC Tablet secara otomatis ditampilkan dalam Enumerasi InPlaceState default asalkan itu adalah operasi hukum.

Dimungkinkan untuk mencegah Panel Input di tempat dan Ikon Panel Input muncul dengan mengatur Properti ITextInputPanel::InPlaceVisibleOnFocus ke FALSE. Mengaturnya ke TRUE mengembalikannya ke default sistem yang muncul jika memungkinkan, asalkan belum dinonaktifkan oleh pengguna atau Kebijakan Grup. Opsi ini berguna untuk aplikasi yang menyertakan solusi entri teks kustom sebagai alternatif untuk Panel Input.

Nilai defaultnya adalah TRUE.

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::InPlaceVisibleOnFocus.

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