Compartilhar via


Método IMathInputControl::SetPosition (micaut.h)

Modifica o local e o tamanho do controle.

Sintaxe

HRESULT SetPosition(
  [in] LONG Left,
  [in] LONG Top,
  [in] LONG Right,
  [in] LONG Bottom
);

Parâmetros

[in] Left

A posição mais à esquerda do controle.

[in] Top

A posição mais alta do controle.

[in] Right

A posição mais à direita do controle.

[in] Bottom

A posição mais baixa do controle.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
S_FALSE
O controle foi redimensionado, mas a largura, a altura ou ambos resultantes não são iguais aos parâmetros de entrada.
E_FAIL
Ocorreu um erro não especificado.

Comentários

Esse método pode ser chamado independentemente do estado de visibilidade do controle.

Esse método terá êxito mesmo se os parâmetros não forem válidos. Se o retângulo for maior que o tamanho máximo permitido do controle (janela da área de trabalho), o tamanho máximo possível será usado. Se o retângulo for menor que o tamanho mínimo do controle ou muito pequeno para manter a visualização de tinta e resultado intacta, o tamanho mínimo possível será usado.

Se o método retornar S_FALSE, o método GetPosition retornará as características de tamanho real do controle.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho micaut.h (inclua Micaut.h)

Confira também

Getposition

IMathInputControl