Metode ITextInputPanel::get_InPlaceVisibleOnFocus (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 menetapkan nilai yang menunjukkan apakah Panel Input PC Tablet ditampilkan secara otomatis ketika jendela tempatnya terpasang mendapatkan fokus.

Properti ini bersifat baca/tulis.

Sintaks

HRESULT get_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 menunjukkan 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 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, kemudian 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