Udostępnij za pośrednictwem

Programowanie panelu wejściowego przy użyciu klasy PenInputPanel

  • Artykuł

[Panel wprowadzania danych piórem został zastąpiony przez Microsoft.Ink.TextInput. Zapoznaj się z tematem Programowanie panelu wprowadzania tekstu.]

Opis używania obiektu PenInputPanel do programowania panelu wejściowego komputera tabletu na poziomie systemu.

Panel wejściowy a obiekt PenInputPanel

W systemie Microsoft Windows XP Tablet PC Edition w wersji 1.0 na poziomie systemowym Tablet PC Input Panel zapewnia uniwersalny mechanizm umożliwiający wprowadzanie tekstu na platformie Windows, ale nie zapewnia dostępu programowego. W systemie Windows XP Tablet PC Edition Software Development Kit (SDK) w wersji 1.5 lub nowszej obiektPenInputPanel umożliwia integrację narzędzi wprowadzania tekstu bezpośrednio z aplikacjami i zapewnienie poziomu kontroli, który nie był wcześniej dostępny. Począwszy od systemu Windows XP Tablet PC Edition 2005, Panel Wprowadzania na poziomie systemu został zaktualizowany, aby uwzględnić funkcje wprowadzania na miejscu udostępniane przez obiekt PenInputPanel i nie tylko.

Na poniższej ilustracji przedstawiono Panel wejściowy wyświetlany nad przykładowym formularzem roszczeń ubezpieczeniowych .

panelu wejściowego wyświetlanego w formularzu używanym do oświadczeń samochodowych

Panel wprowadzania zastępuje PenInputPanel przez zapewnienie tej samej funkcjonalności wprowadzania w miejscu dla każdej aplikacji działającej w systemie Windows XP Tablet PC Edition 2005 lub nowszym, bez potrzeby dodatkowego kodu. Ten artykuł dotyczący korzystania z obiektu PenInputPanel jest dostarczany w celu zapewnienia zgodności wstecznej. Aplikacje, które już korzystają z obiektu PenInputPanel, będą działać tak samo, z wyjątkiem tego, że panel wejściowy będzie wyświetlany zamiast PenInputPanel po uruchomieniu aplikacji w systemie Windows XP Tablet PC Edition 2005 lub nowszym.

Jeśli tworzysz nową aplikację dla komputera typu Tablet PC i chcesz mieć wbudowane rozwiązanie do wprowadzania danych przez użytkownika, panel wprowadzania danych zapewnia to automatycznie w systemie Windows XP Tablet PC Edition 2005 i nowszych. Nie ma potrzeby tworzenia instancji obiektu PenInputPanel.

Wyłączanie panelu wejściowego

Mogą wystąpić przypadki, w których chcesz wyłączyć Panel Wprowadzania. Istnieją dwa sposoby, aby to osiągnąć. Można to zrobić programowo lub ustawiając wpis rejestru, który wyłącza Panel danych wejściowych dla całej aplikacji.

Programowe wyłączanie panelu wejściowego

Aby programowo wyłączyć panel wejściowy, utwórz wystąpienie PenInputPanel i ustaw jego właściwość AutoShow na 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;
}

Aby wyłączyć panel wejściowy dla wielu kontrolek w jednej aplikacji, można utworzyć obiekt PenInputPanel dla każdej kontrolki i ustawić właściwość AutoShowna False dla każdej z nich lub utworzyć jedno wystąpienie PenInputPanel i przenosić je między kontrolkami w miarę zmiany fokusu wejściowego. Aby uzyskać więcej informacji na temat tych dwóch technik, zobacz temat PenInputPanel Sample.

Wyłączanie panelu wprowadzania za pośrednictwem rejestru

Możesz ustawić wpis rejestru, aby wyłączyć panel wejściowy dla całej aplikacji. Jednak spowoduje to również wyłączenie go dla typowych okien dialogowych, takich jak okno dialogowe Otwieranie pliku , okno dialogowe drukowania i okno dialogowe Zapisywanie pliku . Może to sprawić, że środowisko użytkownika w aplikacji będzie niespójne z innymi aplikacjami tabletu.

Ustawienie klucza rejestru DisableInPlace na zero uniemożliwia wyświetlenie interfejsu użytkownika panelu wejściowego w aplikacji. Należy umieścić klucz rejestru DisableInPlace w HKEY_LOCAL_MACHINE\Software\Microsoft\TabletTip\. Następnie dodaj nową wartość rejestru, używając pełnej ścieżki aplikacji, w której chcesz wyłączyć Panel Wprowadzania. Poniższy przykładowy wpis rejestru wyłącza panel wejściowy w aplikacji o nazwie MyApp:

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

Jeśli nadal widzisz problem w aplikacji po wyłączeniu interfejsu użytkownika panelu danych wejściowych, może być konieczne wyłączenie podstawowej platformy, która wysyła zapytanie do aplikacji o lokalizację karetki. Na przykład panel wejściowy może uwidocznić usterkę w kodzie śledzenia kursora aplikacji. Wyłączenie śledzenia kursora uniemożliwia również wyświetlenie interfejsu panelu wprowadzania danych. Aby wyłączyć framework, ustaw klucz rejestru EnableCaretTracking na 0. Znajdź ten klucz w HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\AppCompatFlags\CaretTracking\.

Notatka

Narzędzia ułatwień dostępu i technologia mowy w systemie Windows XP również korzystają z tej struktury, dlatego wyłączenie zapytania powoduje również wyłączenie tych funkcji w aplikacji.

 

Panel wejściowy i strony internetowe

Aby można było używać interfejsu API na stronie sieci Web, musi działać w środowisku częściowego zaufania. Wszystkie składowe klasy PenInputPanel wymagają pełnego zaufania z wyjątkiem następujących:

Te interfejsy API działają w środowisku o częściowym zaufaniu, takim jak strona internetowa, umożliwiając utworzenie wystąpienia obiektu PenInputPanel, dołączenie go do elementu sterującego i wyłączenie Panelu wprowadzania dla tego elementu. Aby uzyskać więcej informacji, zobacz Programowanie panelu wejściowego przy użyciu klasy PenInputPanel i pisma odk w sieci Web.

Obiekt PenInputPanel

W pozostałej części tego tematu opisano sposób używania obiektu PenInputPanel w aplikacjach z obsługą komputera typu Tablet. W szczególności w tym temacie odwołuje się do obiektu PenInputPanel podczas omawiania obiektu programowania, panelu wprowadzania pióra podczas odwoływania się do elementu interfejsu użytkownika i panelu wprowadzania komputera (lub panelu wejściowego) podczas odwoływania się do globalnego panelu wejściowego zwykle znajdującego się po stronie ekranu tabletu.

W poniższych sekcjach opisano obiekt PenInputPanel i interfejs użytkownika.