ITextInputPanel::SetInPlaceVisibility method (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.

]

Menampilkan atau menyembunyikan Panel Input PC Tablet.

Sintaks

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

Parameter

Visible

TRUE untuk menampilkan Panel Input; FALSE untuk menyembunyikan Panel Input.

Nilai kembali

Jika Panel Input dapat ditampilkan, metode akan mengembalikan S_OK, jika tidak , E_FAIL. Lihat bagian Keterangan untuk informasi selengkapnya tentang kapan Panel Input dapat dan tidak dapat dipengaruhi oleh Metode ITextInputPanel::SetInPlaceVisibility.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.

Keterangan

Panel Input ditampilkan seperti yang ditentukan oleh properti Properti ITextInputPanel::CurrentInPlaceState .

Memanggil ITextInputPanel::SetInPlaceVisibility Method dengan parameter Visible yang diatur ke TRUE akan gagal jika Panel Input sudah terlihat.

Jika pengguna telah menonaktifkan mode di tempat dari dialog opsi Panel Input, memanggil Metode ITextInputPanel::SetInPlaceVisibility akan gagal.

Tinta apa pun yang sudah ada di Panel Input, ketika visibilitas berubah, secara otomatis dimasukkan.

Metode ini tidak mengubah nilai Properti ITextInputPanel::InPlaceVisibleOnFocus, dan pada perubahan fokus berikutnya, perilaku kembali ke perilaku yang ditentukan oleh Properti ITextInputPanel::InPlaceVisibleOnFocus.

Metode ITextInputPanel::SetInPlaceVisibility adalah panggilan sinkron. Visibilitas Panel Input akan berubah sebelum panggilan kembali.

Contoh

Contoh C++ ini mengimplementasikan EN_SETFOCUS penanganan aktivitas untuk kontrol Edit, IDC_EDIT1. Ini pertama-tama memeriksa apakah objek ITextInputPanel , g_pTip, telah dibuat. Jika ada, itu mencegah Panel Input ditampilkan dengan memanggil Metode ITextInputPanel::SetInPlaceVisibility dengan nilai false untuk parameter Terlihat .

void CCOMTIPDlg::OnEnSetfocusEdit1()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceVisibility(false)))
		{
			TRACE("Successfully hid the Input Panel.\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