Metode ITextInputPanel::get_CurrentInputArea (peninputpanel.h)

Artikel
03/04/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 area input saat ini seperti yang ditentukan oleh Enumerasi PanelInputArea.

Properti ini bersifat hanya baca.

Sintaks

HRESULT get_CurrentInputArea(
  PanelInputArea *Area
);

Parameter

Area

Mengembalikan nilai

Tidak ada

Keterangan

Area input saat ini berbeda dari area input default ketika pengguna telah secara eksplisit beralih area input. Ini juga berbeda jika area input default tidak tersedia karena pengenal saat ini tidak mendukung mode tersebut atau karena tidak ada pengenal untuk bahasa input saat ini. Ketika Panel Input PC Tablet ditutup atau disembunyikan, area input saat ini diatur ulang ke area input default yang sama, kecuali status defaultnya adalah Otomatis, dalam hal ini, area input saat ini tidak diatur ulang dan mewakili area input terakhir yang terlihat.

Contoh

Contoh C++ ini mengimplementasikan EN_SETFOCUS penanganan aktivitas untuk kontrol Edit, IDC_EDIT3. Pertama-tama memeriksa apakah objek ITextInputPanel , g_pTip, telah dibuat. Jika ada, ia melaporkan nilai beberapa properti Antarmuka ITextInputPanel untuk men-debug output menggunakan makro TRACE .

void CCOMTIPDlg::OnEnSetFocusEdit3()
{
    if (NULL != g_pTip)
    {
		CorrectionMode mode;

		if (SUCCEEDED(g_pTip->get_CurrentCorrectionMode(&mode)))
        {
			TRACE("CurrentCorrectionMode: %d\n", mode);
		}

		InPlaceState state;

		if (SUCCEEDED(g_pTip->get_CurrentInPlaceState(&state)))
        {
			TRACE("CurrentInPlaceState: %d\n", state);
		}

		PanelInputArea area;

		if (SUCCEEDED(g_pTip->get_CurrentInputArea(&area)))
        {
			TRACE("CurrentInputArea: %d\n", area);
		}

		InteractionMode iMode;

		if (SUCCEEDED(g_pTip->get_CurrentInteractionMode(&iMode)))
        {
			TRACE("CurrentInteractionMode: %d\n", iMode);
		}

        RECT rect;

		if (SUCCEEDED(g_pTip->get_InPlaceBoundingRectangle(&rect)))
        {
	        TRACE("InPlaceBoundingRectangle.top: %d\n", rect.top);
	        TRACE("InPlaceBoundingRectangle.left: %d\n", rect.left);
	        TRACE("InPlaceBoundingRectangle.bottom: %d\n", rect.bottom);
	        TRACE("InPlaceBoundingRectangle.right: %d\n", rect.right);
        }

	    int nHeight;

		if (SUCCEEDED(g_pTip->get_PopDownCorrectionHeight(&nHeight)))
        {
	        TRACE("PopDownCorrectionHeight: %d\n", nHeight);
        }

	    if (SUCCEEDED(g_pTip->get_PopUpCorrectionHeight(&nHeight)))
        {
	        TRACE("PopUpCorrectionHeight: %d\n", nHeight);
        }

		if (SUCCEEDED(g_pTip->SetInPlacePosition(300, 300, CorrectionPosition_Bottom)))
		{
			TRACE("Call to SetInPlacePosition() succeeded.\n");
		}
		else
		{
			TRACE("Call to SetInPlacePosition() failed.\n");
		}
    }
    else
    {
        TRACE("ITextInputPanel object is NULL.\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