Método ITextInputPanel::SetInPlaceVisibility (peninputpanel.h)

Artículo
03/01/2024

[ITextInputPanel está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use IInputPanelConfiguration.

]

Muestra u oculta el panel de entrada del pc tableta.

Sintaxis

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

Parámetros

Visible

TRUE para mostrar el Panel de entrada; FALSE para ocultar el Panel de entrada.

Valor devuelto

Si se puede mostrar el Panel de entrada, el método devuelve S_OK; de lo contrario, E_FAIL. Vea la sección Comentarios para obtener más información sobre cuándo el Panel de entrada puede y no puede verse afectado por el método ITextInputPanel::SetInPlaceVisibility.

Código devuelto	Descripción
S_OK	Correcto.
E_FAIL	Se ha producido un error no especificado.

Comentarios

El Panel de entrada se muestra como se especifica en la propiedad ITextInputPanel::CurrentInPlaceState Property .

Al llamar al método ITextInputPanel::SetInPlaceVisibility con el parámetro Visible establecido en TRUE , se producirá un error si el Panel de entrada ya está visible.

Si el usuario ha deshabilitado el modo local desde el cuadro de diálogo opciones del Panel de entrada, se producirá un error al llamar al método ITextInputPanel::SetInPlaceVisibility .

Cualquier entrada de lápiz que ya esté en el Panel de entrada, cuando cambia la visibilidad, se inserta automáticamente.

Este método no cambia el valor de ITextInputPanel::InPlaceVisibleOnFocus Property y, en el cambio de foco posterior, el comportamiento se revierte al comportamiento especificado por la propiedad ITextInputPanel::InPlaceVisibleOnFocus.

El método ITextInputPanel::SetInPlaceVisibility es una llamada sincrónica. La visibilidad del Panel de entrada cambiará antes de que se devuelva la llamada.

Ejemplos

En este ejemplo de C++ se implementa un EN_SETFOCUS controlador de eventos para un control Edit, IDC_EDIT1. Primero comprueba si se ha creado un objeto ITextInputPanel , g_pTip, . Si existe, impide que el Panel de entrada se muestre llamando al método ITextInputPanel::SetInPlaceVisibility con un valor false para el parámetro Visible .

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	peninputpanel.h
Archivo DLL	Tiptsf.dll