Partager via

Programmation du panneau d’entrée à l’aide de la classe PenInputPanel

  • Article

[PenInputPanel a été remplacé par Microsoft.Ink.TextInput. Reportez-vous à Programmation du panneau d’entrée de texte.]

Description de l’utilisation de l’objet PenInputPanel pour programmer le panneau d’entrée Tablet PC au niveau du système.

Panneau d’entrée et objet PenInputPanel

Dans Microsoft Windows XP Édition Tablet PC version 1.0, le panneau d’entrée Tablet PC au niveau du système fournit un mécanisme universel pour effectuer l’entrée de texte sur la plateforme Windows, mais il ne fournit pas d’accès par programmation. Dans windows XP Tablet PC Edition Software Development Kit (SDK) version 1.5 et ultérieure, l’objet PenInputPanel vous permet d’intégrer des outils d’entrée de texte directement dans vos applications et de fournir un niveau de contrôle qui n’était pas disponible auparavant. À compter de Windows XP Édition Tablet PC 2005, le panneau d’entrée au niveau du système a été mis à niveau pour inclure la fonctionnalité d’entrée sur place fournie par l’objet PenInputPanel et bien plus encore.

Le graphique suivant montre le panneau d’entrée affiché sur l’exemple d’exemple de formulaire de revendications automatiques .

panneau d’entrée affiché sur un formulaire utilisé pour les revendications automobiles

Le panneau d’entrée remplace le PenInputPanel en fournissant la même fonctionnalité d’entrée sur place à toute application s’exécutant sur Windows XP Tablet PC Edition 2005 ou version ultérieure sans avoir besoin de code supplémentaire. Cet article sur l’utilisation de l’objet PenInputPanel est fourni pour la compatibilité descendante. Les applications qui utilisent déjà l’objet PenInputPanel fonctionnent de la même manière, sauf que le panneau d’entrée s’affiche à la place du PenInputPanel lorsque l’application est exécutée sur Windows XP Édition Tablet PC 2005 ou ultérieure.

Si vous développez une nouvelle application pour le Tablet PC et que vous souhaitez disposer d’une solution d’entrée utilisateur sur place, le Panneau d’entrée fournit automatiquement cette fonctionnalité sur Windows XP Édition Tablet PC 2005 ou ultérieure. Il n’est pas nécessaire d’instancier l’objet PenInputPanel .

Désactivation du panneau d’entrée

Dans certains cas, vous souhaitez désactiver le panneau d’entrée. Il existe deux façons d'accomplir cela. Vous pouvez effectuer cette opération par programmation ou en définissant une entrée de Registre qui désactive le panneau d’entrée pour l’ensemble de votre application.

Désactivation du panneau d’entrée par programmation

Pour désactiver le panneau d’entrée par programmation, instanciez le PenInputPanel et définissez sa propriété AutoShow sur 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;
}

Pour désactiver le panneau d’entrée pour plusieurs contrôles dans une seule application, instanciez un objet PenInputPanel pour chaque contrôle et définissez la propriété AutoShowsur False pour chacun d’eux ou instanciez un seul PenInputPanel et déplacez-le du contrôle au contrôle à mesure que le focus d’entrée change. Pour plus d’informations sur ces deux techniques, consultez la rubrique Exemple PenInputPanel .

Désactivation du panneau d’entrée via le Registre

Vous pouvez définir une entrée de Registre pour désactiver le panneau d’entrée pour l’ensemble de votre application. Toutefois, cela le désactive également pour les boîtes de dialogue courantes telles que la boîte de dialogue Ouvrir le fichier , la boîte de dialogue Imprimer et la boîte de dialogue Enregistrer le fichier . Cela peut rendre l’expérience utilisateur dans votre application incohérente avec d’autres applications Tablet PC.

La définition de la clé de DisableInPlace Registre sur zéro empêche l’interface utilisateur du panneau d’entrée d’apparaître dans une application. Vous devez placer la clé de DisableInPlace Registre sur HKEY_LOCAL_MACHINE\Software\Microsoft\TabletTip\. Ensuite, ajoutez une nouvelle valeur de Registre à l’aide du chemin d’accès complet de l’application dans laquelle vous souhaitez désactiver le panneau d’entrée. L’exemple d’entrée de Registre suivant désactive le panneau d’entrée dans une application appelée MyApp :

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

Si vous voyez toujours un problème dans votre application après avoir désactivé l’interface utilisateur du panneau d’entrée, il peut être nécessaire de désactiver l’infrastructure sous-jacente, qui interroge votre application pour l’emplacement de la caret. Par exemple, le panneau d’entrée peut exposer un bogue dans le code de suivi de votre application. La désactivation de la requête de suivi des carets empêche également l’interface utilisateur du panneau d’entrée d’apparaître. Pour désactiver l’infrastructure, définissez la clé de EnableCaretTracking Registre sur zéro. Recherchez cette clé à l’adresse HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\AppCompatFlags\CaretTracking\.

Notes

Les outils d’accessibilité et la technologie vocale dans Windows XP utilisent également cette infrastructure. Par conséquent, la désactivation de la requête désactive également ces fonctionnalités dans votre application.

 

Panneau d’entrée et pages web

Pour utiliser une API sur une page web, elle doit fonctionner dans un environnement d’approbation partielle. Tous les membres de la classe PenInputPanel ont besoin d’une confiance totale, à l’exception des éléments suivants :

Ces API fonctionnent dans un environnement d’approbation partielle, tel qu’une page Web, ce qui vous permet d’instancier un objet PenInputPanel , de l’attacher à un contrôle et de désactiver le panneau d’entrée pour ce contrôle. Pour plus d’informations, consultez Programmation du panneau d’entrée à l’aide de la classe PenInputPanel et De l’encre sur le web.

Objet PenInputPanel

Le reste de cette rubrique explique comment utiliser l’objet PenInputPanel dans vos applications compatibles avec Tablet PC. Plus spécifiquement, cette rubrique fait référence à l’objet PenInputPanel lors de la discussion de l’objet de programmation, au panneau d’entrée du stylet lorsque vous faites référence à l’élément d’interface utilisateur et au panneau d’entrée du PC (ou panneau d’entrée) lorsque vous faites référence au panneau d’entrée global généralement présent sur le côté de l’écran tablet PC.

Les sections suivantes décrivent l’objet et l’interface utilisateur PenInputPanel .