Programando o painel de entrada usando a classe PenInputPanel

[PenInputPanel foi substituído por Microsoft.Ink.TextInput. Consulte Programação do Painel de Entrada de Texto.]

Descrição do uso do objeto PenInputPanel para programar o painel de entrada do Tablet PC no nível do sistema.

Painel de entrada vs. o objeto PenInputPanel

No Microsoft Windows XP Tablet PC Edition versão 1.0, o painel de entrada do Tablet PC no nível do sistema fornece um mecanismo universal para realizar a entrada de texto na plataforma Windows, mas não fornece acesso programático. No Windows XP Tablet PC Edition Software Development Kit (SDK) versão 1.5 e posterior, o objeto PenInputPanel permite integrar ferramentas de entrada de texto diretamente em seus aplicativos e fornecer um nível de controle não disponível anteriormente. A partir do Windows XP Tablet PC Edition 2005, o Painel de Entrada ao nível do sistema foi melhorado para incluir a funcionalidade de entrada in-place fornecida pelo objeto PenInputPanel e muito mais.

O gráfico a seguir mostra o Painel de Introdução exibido sobre o exemplo do Formulário de Declarações de Sinistros Automáticos.

O Painel de Entrada substitui o PenInputPanel fornecendo a mesma funcionalidade de entrada diretamente para qualquer aplicação a correr no Windows XP Tablet PC Edition 2005 ou posterior sem a necessidade de código adicional. Este artigo sobre como usar o objeto PenInputPanel é fornecido para garantir compatibilidade retroativa. Os aplicativos que já utilizam o objeto PenInputPanel funcionarão da mesma forma, exceto que o Painel de Entrada será exibido em vez do PenInputPanel quando o aplicativo for executado no Windows XP Tablet PC Edition 2005 ou posterior.

Se estiver a desenvolver uma nova aplicação e quiser ter uma solução integrada de entrada de utilizador, o Painel de Entrada fornece isso automaticamente no Windows XP Tablet PC Edition 2005 ou posterior. Não há necessidade de instanciar o objeto PenInputPanel.

Desativando o Painel de Entrada

Pode haver casos em que você queira desativar o Painel de Entrada. Há duas maneiras de conseguir isso. Você pode fazer isso programaticamente ou definindo uma entrada do Registro que desativa o Painel de Entrada para todo o seu aplicativo.

Desativando o painel de entrada programaticamente

Para desativar o Painel de Entrada através de programação, instancie o PenInputPanel e defina a sua propriedade AutoShow como False.

using Microsoft.Ink;

// ...

private PenInputPanel theInputPanel;

// ...

private void Form1_Load(object sender, System.EventArgs e)
{
// Attach the Input Panel to a specific TextBox control.
theInputPanel = new PenInputPanel(textBox1);

// Disable the Input Panel for the TextBox.
theInputPanel.AutoShow = false;
}

Para desativar o Painel de Entrada para vários controlos num único aplicativo, instancie um objetoPenInputPanelpara cada controlo e defina a propriedade AutoShowpara False para cada um ou instancie um único PenInputPanel e mova-o de controlo para controlo à medida que o foco de entrada se altera. Para obter mais informações sobre estas duas técnicas, consulte o tópico PenInputPanel Sample.

Desativar o Painel de Entrada através do Registo

Você pode definir uma entrada do Registro para desabilitar o Painel de Entrada para todo o seu aplicativo. No entanto, isso também o desativará para caixas de diálogo comuns, como a caixa de diálogo Arquivo Abrir , a caixa de diálogo Arquivo Imprimir e a caixa de diálogo Arquivo Salvar . Isso pode tornar a experiência do usuário em seu aplicativo inconsistente com outros aplicativos do Tablet PC.

Definir a chave do Registro DisableInPlace como zero impede que a interface do usuário (UI) do Painel de Entrada apareça em um aplicativo. Tem de colocar a chave de registo DisableInPlace em HKEY_LOCAL_MACHINE\Software\Microsoft\TabletTip\. Em seguida, adicione um novo valor do Registro usando o caminho completo do aplicativo no qual você deseja desabilitar o Painel de Entrada. O exemplo de entrada do Registro a seguir desabilita o Painel de Entrada em um aplicativo chamado MyApp:

[HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\WindowsNT\TabletTIP\DisableInPlace]``"C:\Program Files\My App\MyApp.exe"=dword:00000000

Se ainda verificar um problema na sua aplicação depois de desativar a interface do utilizador do Painel de Entrada, poderá ser necessário desativar a estrutura subjacente, que consulta a sua aplicação para a posição do cursor. Por exemplo, o Painel de Entrada pode expor um bug no código de acompanhamento do cursor da sua aplicação. Desativar a consulta de seguimento do cursor também impede que a interface do Painel de Entrada apareça. Para desativar a estrutura, defina a chave do Registro EnableCaretTracking como zero. Localize esta chave em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\AppCompatFlags\CaretTracking\.

O Painel de Entrada e as Páginas Web

Para usar uma API em uma página da Web, ela deve funcionar em um ambiente de confiança parcial. Todos os membros da classe PenInputPanel exigem confiança total, exceto os seguintes:

• PenInputPanel Construtores (somente código gerenciado)
• Método Dispose (somente código gerenciado)
• AttachedEditControl Property (somente código gerenciado)
• AutoShow Property

Essas APIs funcionam num ambiente de confiança parcial, como uma página da web, permitindo-lhe instanciar um objeto PenInputPanel, anexá-lo a um controlo e desativar o Painel de Introdução para esse controlo. Para obter mais informações, consulte Programar o painel de entrada usando a classe PenInputPanel e Ink na Web.

O objeto PenInputPanel

O restante deste tópico descreve como usar o objeto PenInputPanel nos seus aplicativos ativados para Tablet PC. Mais especificamente, este tópico refere-se ao objeto PenInputPanel quando se discute o objeto de programação, ao painel de entrada por caneta ao referir-se ao elemento da interface de utilizador e ao Painel de Entrada do PC (ou Painel de Entrada) ao referir-se ao painel de entrada global normalmente encontrado na lateral da tela do Tablet PC.

As seções a seguir descrevem o objeto PenInputPanel e a interface do usuário.

• Sobre o painel de entrada
• Instanciando a classe PenInputPanel
• Suporte Fatoide
• Estrutura de Serviços de Texto
• Melhores Práticas