Programmation du panneau de saisie à l’aide de la classe PenInputPanel
[PenInputPanel a été remplacé par Microsoft. Ink. TextInput. Consultez programmation du panneau de saisie de texte.]
Description de l’utilisation de l’objet PenInputPanel pour programmer le panneau de saisie Tablet PC au niveau système.
Panneau de saisie et objet PenInputPanel
dans Microsoft Windows XP édition Tablet pc version 1,0, le panneau de saisie tablet pc au niveau du système fournit un mécanisme universel permettant d’effectuer des entrées de texte sur la plateforme Windows, mais il ne fournit pas d’accès par programme. dans Windows XP Tablet PC Edition (kit de développement logiciel (SDK)) version 1,5 et versions ultérieures, l’objet PenInputPanel vous permet d’intégrer les outils d’entrée de texte directement dans vos applications et de fournir un niveau de contrôle non disponible précédemment. depuis la Windows XP édition Tablet PC 2005, le panneau de saisie 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 de saisie affiché sur l’exemple d’exemple de formulaire de déclaration automatique .

le panneau de saisie remplace le PenInputPanel en fournissant la même fonctionnalité d’entrée sur place à toute application s’exécutant sur Windows XP édition Tablet PC 2005 ou version ultérieure sans nécessiter de code supplémentaire. Cet article sur l’utilisation de l’objet PenInputPanel est fourni à des fins de compatibilité descendante. les Applications qui utilisent déjà l’objet PenInputPanel fonctionneront de la même façon, à ceci près que le panneau de saisie sera affiché à la place du PenInputPanel lorsque l’application sera exécutée sur Windows XP édition Tablet PC 2005 ou version ultérieure.
si vous développez une nouvelle application pour Tablet PC et que vous souhaitez disposer d’une solution d’entrée d’utilisateur sur place, le panneau de saisie le fournit automatiquement sur Windows XP édition Tablet pc 2005 ou version ultérieure. Il n’est pas nécessaire d’instancier l’objet PenInputPanel .
Désactivation du panneau de saisie
Il peut arriver que vous souhaitiez désactiver le panneau de saisie. Il existe deux façons d'accomplir cela. Vous pouvez le faire par programme ou en définissant une entrée de Registre qui désactive le panneau de saisie pour l’ensemble de votre application.
Désactivation du panneau de saisie par programmation
Pour désactiver le panneau de saisie par programme, 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 de saisie pour plusieurs contrôles dans une même application, instanciez un objet PenInputPanel pour chaque contrôle et affectez la valeur false à la propriété affichageautomatique pour chaque ou instanciez un PenInputPanel unique et déplacez-le du contrôle au contrôle en tant que Focus d’entrée. Pour plus d’informations sur ces deux techniques, consultez l’exemple de rubrique PenInputPanel .
Désactivation du panneau de saisie dans le registre
Vous pouvez définir une entrée de Registre pour désactiver le panneau de saisie pour l’ensemble de votre application. Toutefois, cette opération est également désactivée pour les boîtes de dialogue courantes telles que la boîte de dialogue ouvrir un fichier , la boîte de dialogue Imprimer et la boîte de dialogue enregistrement de fichier . Cela peut rendre l’expérience utilisateur dans votre application incohérente avec les autres applications Tablet PC.
La définition de la DisableInPlace clé de Registre sur zéro empêche l’affichage de l’interface utilisateur du panneau de saisie dans une application. Vous devez placer la DisableInPlace clé de Registre à l’emplacement HKEY_LOCAL_MACHINE\Software\Microsoft\TabletTip\ . Ensuite, ajoutez une nouvelle valeur de registre en utilisant le chemin d’accès complet de l’application dans laquelle vous souhaitez désactiver le panneau de saisie. L’exemple d’entrée de Registre suivant désactive le panneau de saisie dans une application nommée MyApp :
[HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\WindowsNT\TabletTIP\DisableInPlace]``"C:\Program Files\My App\MyApp.exe"=dword:00000000
Si vous rencontrez toujours un problème dans votre application après avoir désactivé l’interface utilisateur du panneau de saisie, il peut être nécessaire de désactiver l’infrastructure sous-jacente, qui interroge votre application à la recherche de l’emplacement du signe insertion. Par exemple, le panneau de saisie peut exposer un bogue dans le code de suivi du signe insertion de votre application. La désactivation de la requête de suivi du signe insertion empêche également l’interface utilisateur du panneau de saisie d’apparaître. Pour désactiver le Framework, définissez la EnableCaretTracking clé de Registre sur zéro. Localisez 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 ce framework. par conséquent, la désactivation de la requête désactive également ces fonctionnalités dans votre application.
Le panneau de saisie et les pages Web
Pour pouvoir utiliser une API sur une page Web, elle doit fonctionner dans un environnement de confiance partielle. Tous les membres de la classe PenInputPanel requièrent une confiance totale, à l’exception des éléments suivants :
- Constructeurs PenInputPanel (code managé uniquement)
- Dispose, méthode (code managé uniquement)
- Propriété AttachedEditControl (code managé uniquement)
- Affichage automatique, propriété
Ces API fonctionnent dans un environnement de confiance partielle, tel qu’une page Web, vous permettant d’instancier un objet PenInputPanel , de l’attacher à un contrôle et de désactiver le panneau de saisie pour ce contrôle. Pour plus d’informations, consultez programmation du panneau de saisie à 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 lorsqu’il s’agit de décrire l’objet de programmation, le panneau de saisie du stylet pour faire référence à l’élément d’interface utilisateur et le panneau de saisie du PC (ou le panneau de saisie) quand vous faites référence au panneau de saisie global généralement situé sur le côté de l’écran du Tablet PC.
Les sections suivantes décrivent l’objet PenInputPanel et l’interface utilisateur.