Delen via

Het invoervenster programmeren met behulp van de klasse PenInputPanel

[PenInputPanel is vervangen door Microsoft.Ink.TextInput. Raadpleeg Het programmeren van het tekstinvoervenster.

Beschrijving van het gebruik van het PenInputPanel-object om het systeemniveau Tablet PC-Invoerpaneel te programmeren.

Invoerpaneel versus het PenInputPanel-object

In Microsoft Windows XP Tablet PC Edition versie 1.0 biedt het invoerpaneel tablet pc op systeemniveau een universeel mechanisme voor het uitvoeren van tekstinvoer op het Windows-platform, maar het biedt geen programmatische toegang. In Windows XP Tablet PC Edition Software Development Kit (SDK) versie 1.5 en hoger kunt u met het PenInputPanel-object tekstinvoerhulpprogramma's rechtstreeks integreren in uw toepassingen en een besturingselement bieden dat niet eerder beschikbaar is. Vanaf de Windows XP Tablet PC Edition 2005 is het invoerpaneel op systeemniveau bijgewerkt om de in-place invoerfunctionaliteit van het PenInputPanel object en meer op te nemen.

In de volgende afbeelding ziet u het invoerpaneel dat wordt weergegeven over het Auto Claims Formulier voorbeeld.

invoerpaneel weergegeven in een formulier dat wordt gebruikt voor autoclaims

Het invoerpaneel vervangt de PenInputPanel- door te voorzien in dezelfde in-place invoerfunctionaliteit voor elke toepassing die wordt uitgevoerd op Windows XP Tablet PC Edition 2005 of hoger, zonder dat er extra code nodig is. Dit artikel over het gebruik van het PenInputPanel-object is bedoeld voor achterwaartse compatibiliteit. Toepassingen die al gebruikmaken van het PenInputPanel--object werken hetzelfde, behalve dat het invoervenster wordt weergegeven in plaats van de PenInputPanel wanneer de toepassing wordt uitgevoerd op Windows XP Tablet PC Edition 2005 of hoger.

Als u een nieuwe toepassing voor de tablet-pc ontwikkelt en een in-place gebruikersinvoeroplossing wilt hebben, biedt het invoerpaneel dit automatisch op Windows XP Tablet PC Edition 2005 of hoger. U hoeft het PenInputPanel--object niet te instantiëren.

Het invoerpaneel uitschakelen

Mogelijk wilt u het invoervenster uitschakelen. Er zijn twee manieren om dit te bereiken. U kunt dit programmatisch doen of door een registervermelding in te stellen waarmee het invoerpaneel voor uw hele toepassing wordt uitgeschakeld.

Invoerpaneel programmatisch uitschakelen

Als u het invoerpaneel programmatisch wilt uitschakelen, moet u een instantie van de PenInputPanel maken en vervolgens de eigenschap AutoShow instellen op 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;
}

Als u het invoerpaneel voor meerdere besturingselementen in één toepassing wilt uitschakelen, kunt u voor elk besturingselement een PenInputPanel--object maken en de eigenschap AutoShowinstellen op False, of u maakt één PenInputPanel en verplaatst deze van het ene besturingselement naar het andere naarmate de invoerfocus verandert. Zie het onderwerp PenInputPanel Sample voor meer informatie over deze twee technieken.

Invoerpaneel uitschakelen via het register

U kunt een registervermelding instellen om het invoerpaneel voor uw hele toepassing uit te schakelen. Dit wordt echter ook uitgeschakeld voor algemene dialoogvensters, zoals het dialoogvenster Bestand openen, het dialoogvenster Afdrukken en het dialoogvenster Bestand opslaan. Hierdoor kan de gebruikerservaring in uw toepassing inconsistent zijn met andere Tablet PC-toepassingen.

Als u de DisableInPlace registersleutel op nul instelt, voorkomt u dat de gebruikersinterface van het invoervenster (UI) in een toepassing wordt weergegeven. U moet de DisableInPlace registersleutel op HKEY_LOCAL_MACHINE\Software\Microsoft\TabletTip\plaatsen. Voeg vervolgens een nieuwe registerwaarde toe met behulp van het volledige pad van de toepassing waarin u het invoervenster wilt uitschakelen. Met de volgende voorbeeldregistervermelding wordt het invoervenster uitgeschakeld in een toepassing met de naam MyApp:

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

Als u nog steeds een probleem in uw toepassing ziet nadat u de gebruikersinterface van het invoervenster hebt uitgeschakeld, is het mogelijk nodig om het onderliggende framework uit te schakelen, waarmee uw toepassing wordt opgevraagd voor de caretlocatie. Het invoerpaneel kan bijvoorbeeld een bug onthullen in de code voor het bijhouden van de caret van uw toepassing. Als u de caret-traceringsquery uitschakelt, wordt ook voorkomen dat de gebruikersinterface van het invoerpaneel wordt weergegeven. Als u het framework wilt uitschakelen, stelt u de EnableCaretTracking registersleutel in op nul. Zoek deze sleutel op HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\AppCompatFlags\CaretTracking\.

Notitie

Toegankelijkheidsprogramma's en spraaktechnologie in Windows XP gebruiken dit framework ook. Als u de query uitschakelt, worden deze functies ook uitgeschakeld in uw toepassing.

 

Het invoerpaneel en webpagina's

Als u een API op een webpagina wilt gebruiken, moet deze werken in een gedeeltelijke vertrouwensomgeving. Voor alle PenInputPanel- klasseleden is volledig vertrouwen vereist, met uitzondering van het volgende:

Deze API's werken in een gedeeltelijke vertrouwensomgeving, zoals een webpagina, zodat u een PenInputPanel--object kunt instantiëren, aan een besturingselement kunt koppelen en het invoerpaneel voor dat besturingselement kunt uitschakelen. Zie Het invoerpaneel programmeren met behulp van de PenInputPanel-klasse en Inkt op het webvoor meer informatie.

Het PenInputPanel-object

In de rest van dit onderwerp wordt beschreven hoe u het PenInputPanel--object gebruikt in uw Tablet PC-toepassingen. Meer specifiek verwijst dit onderwerp naar het PenInputPanel object bij het bespreken van het programmeerobject, het peninvoerpaneel wanneer wordt verwezen naar het ui-element en het pc-invoerpaneel (of het invoerpaneel) wanneer u verwijst naar het algemene invoerpaneel dat doorgaans aan de zijkant van het tablet-pc-scherm wordt gevonden.

In de volgende secties wordt het PenInputPanel-object en de gebruikersinterface beschreven.

 

 

  • Last updated on