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

[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.

]

Posiciona explicitamente o destino de foco do Painel de Entrada do Tablet PC nas coordenadas da tela.

Sintaxe

HRESULT SetInPlaceHoverTargetPosition(
  int xPosition,
  int yPosition
);

Parâmetros

xPosition

A coordenada x horizontal para o canto superior esquerdo do destino de foco, sem nenhum pente de correção visível.

yPosition

A coordenada y vertical para o canto superior esquerdo do destino de foco, sem nenhum pente de correção visível.

Retornar valor

Esse método pode retornar um desses valores.

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

Comentários

Não há restrições sobre onde o destino de foco pode ser colocado. O aplicativo é responsável por garantir que o destino de foco permaneça na tela.

O método SetInPlaceHoverTargetPosition é síncrono. O posicionamento ocorre antes que o método retorne.

Exemplos

Este exemplo do C++ implementa um EN_SETFOCUS manipulador de eventos para um controle Editar, IDC_EDIT2. Primeiro, ele verifica se um objeto ITextInputPanel , g_pTip, foi criado. Se existir, ele definirá a posição do destino de foco do Painel de Entrada chamando o Método ITextInputPanel::SetInPlaceHoverTargetPosition. Em seguida, ele relata se a chamada foi bem-sucedida para depurar a saída usando a macro TRACE .

void CCOMTIPDlg::OnEnSetfocusEdit2()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceHoverTargetPosition(300, 300)))
		{
			TRACE("Call to SetInPlaceHoverTargetPosition() succeeded.\n");
		}
		else
		{
			TRACE("Call to SetInPlaceHoverTargetPosition() failed.\n");
		}
	}
    else
    {
        TRACE("ITextInputPanel object is NULL.\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

Confira também

ITextInputPanel Interface

Método ITextInputPanel::SetInPlacePosition

Método ITextInputPanel::SetInPlaceVisibility