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

Artigo
03/05/2024

[ITextInputPanel está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use IInputPanelConfiguration.

]

Mostra ou oculta o Painel de Entrada do Tablet PC.

Sintaxe

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

Parâmetros

Visible

TRUE para mostrar o Painel de Entrada; FALSE para ocultar o Painel de Entrada.

Retornar valor

Se o Painel de Entrada puder ser exibido, o método retornará S_OK, caso contrário , E_FAIL. Consulte a seção Comentários para obter mais informações sobre quando o Painel de Entrada pode e não pode ser afetado pelo Método ITextInputPanel::SetInPlaceVisibility.

Código de retorno	Descrição
S_OK	Êxito.
E_FAIL	Ocorreu um erro não especificado.

Comentários

O Painel de Entrada é mostrado conforme especificado pela propriedade ITextInputPanel::CurrentInPlaceState Property .

Chamar o Método ITextInputPanel::SetInPlaceVisibility com o parâmetro Visible definido como TRUE falhará se o Painel de Entrada já estiver visível.

Se o usuário tiver desabilitado o modo in-loco na caixa de diálogo opções do Painel de Entrada, a chamada do Método ITextInputPanel::SetInPlaceVisibility falhará.

Qualquer tinta já no Painel de Entrada, quando a visibilidade é alterada, é inserida automaticamente.

Esse método não altera o valor da propriedade ITextInputPanel::InPlaceVisibleOnFocus e, na alteração de foco subsequente, o comportamento é revertido para o comportamento especificado pela propriedade ITextInputPanel::InPlaceVisibleOnFocus.

O Método ITextInputPanel::SetInPlaceVisibility é uma chamada síncrona. A visibilidade do Painel de Entrada será alterada antes do retorno da chamada.

Exemplos

Este exemplo do C++ implementa um EN_SETFOCUS manipulador de eventos para um controle Editar, IDC_EDIT1. Primeiro, ele verifica se um objeto ITextInputPanel , g_pTip, foi criado. Se existir, impedirá que o Painel de Entrada seja exibido chamando o Método ITextInputPanel::SetInPlaceVisibility com um valor false para o 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	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	peninputpanel.h
DLL	Tiptsf.dll