Compartilhar via


Método IPenInputPanel::Refresh (peninputpanel.h)

[A atualização não está mais disponível para uso a partir do Windows XP Tablet PC Edition. Em vez disso, use o Painel de Entrada de Texto (TIP).]

Atualizações e restaura as propriedades PenInputPanel com base nas configurações do Painel de Entrada do Tablet PC, posiciona automaticamente o painel de entrada da caneta e define a interface do usuário para o painel padrão.

Sintaxe

HRESULT Refresh();

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_UNEXPECTED
Parâmetro inesperado ou tipo de propriedade.
E_FAIL
Ocorreu um erro não especificado.

Comentários

O método Refresh restaura o painel padrão. Por exemplo, se a propriedade DefaultPanel estiver definida como Teclado e a propriedade CurrentPanel estiver definida como Manuscrito, o método Refresh definirá o painel de entrada da caneta como Teclado. Se a propriedade DefaultPanel estiver definida como Padrão, o método Refresh não alterará o painel de entrada da caneta.

O método Refresh posiciona automaticamente o painel de entrada da caneta em relação ao controle ao qual ele está anexado.

O método Refresh atualiza o painel de entrada da caneta usando as configurações do Painel de Entrada. Por exemplo, você pode fazer alterações no objeto PenInputPanel e, em seguida, chamar Atualizar para restaurar as configurações para aquelas copiadas do Painel de Entrada.

O objeto PenInputPanel é atualizado automaticamente sempre que as configurações do Painel de Entrada são alteradas.

Chamar Atualizar enquanto o painel de entrada da caneta não tiver foco gerará um erro.

Nota Normalmente, você não precisará chamar Atualizar porque todas as opções acima são executadas durante a ativação do painel de entrada da caneta. No entanto, se a propriedade AutoShow estiver definida como FALSE, você poderá desabilitar a ativação do painel de entrada da caneta. Portanto, o método Refresh é necessário.
 

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
Biblioteca InkObj.dll

Confira também

IPenInputPanel

Peninputpanel