Метод ITextInputPanel::SetInPlaceVisibility (peninputpanel.h)

Статья
08/25/2023

[ITextInputPanel доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте IInputPanelConfiguration.

]

Отображает или скрывает панель ввода планшетного компьютера.

Синтаксис

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

Параметры

Visible

Значение TRUE , чтобы отобразить панель ввода; ЗНАЧЕНИЕ FALSE , чтобы скрыть панель ввода.

Возвращаемое значение

Если панель ввода может отображаться, метод возвращает S_OK, в противном случае E_FAIL. Дополнительные сведения о том, когда метод ITextInputPanel::SetInPlaceVisibility может влиять на панель ввода, см. в разделе Примечания.

Код возврата	Описание
S_OK	Успешно.
E_FAIL	Произошла неизвестная ошибка.

Этот метод не изменяет значение свойства ITextInputPanel::InPlaceVisibleOnFocus, а при последующем изменении фокуса поведение возвращается к поведению, заданному свойством ITextInputPanel::InPlaceVisibleOnFocus.

Метод ITextInputPanel::SetInPlaceVisibility является синхронным вызовом. Видимость панели ввода изменится до возврата вызова.

Примеры

В этом примере C++ реализуется EN_SETFOCUS обработчик событий для элемента управления Edit , IDC_EDIT1. Сначала проверяется, g_pTipсоздан ли объект ITextInputPanel . Если он существует, панель ввода не отображается путем вызова метода ITextInputPanel::SetInPlaceVisibility со значением false для параметра Visible .

void CCOMTIPDlg::OnEnSetfocusEdit1()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceVisibility(false)))
		{
			TRACE("Successfully hid the Input Panel.\n");
		}
	}
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	peninputpanel.h
DLL	Tiptsf.dll