Share via

Programmazione del pannello di input tramite la classe PenInputPanel

  • Articolo

[PenInputPanel è stato sostituito da Microsoft.Ink.TextInput. Fare riferimento a Programmazione del pannello di input di testo.]

Descrizione dell'utilizzo dell'oggetto PenInputPanel per programmare il pannello di input tablet PC a livello di sistema.

Pannello di input e oggetto PenInputPanel

In Microsoft Windows XP Tablet PC Edition versione 1.0, il pannello di input tablet PC a livello di sistema fornisce un meccanismo universale per eseguire l'input di testo nella piattaforma Windows, ma non fornisce accesso programmatico. In Windows XP Tablet PC Edition Software Development Kit (SDK) versione 1.5 e successive, l'oggetto PenInputPanel consente di integrare gli strumenti di input di testo direttamente nelle applicazioni e fornire un livello di controllo non disponibile in precedenza. A partire da Windows XP Tablet PC Edition 2005, il pannello di input a livello di sistema è stato aggiornato per includere la funzionalità di input sul posto fornita dall'oggetto PenInputPanel e altro ancora.

La figura seguente mostra il pannello di input visualizzato nell'esempio di esempio modulo attestazioni automatica .

pannello di input visualizzato su un modulo utilizzato per le attestazioni delle automobili

Il pannello di input sostituisce PenInputPanel fornendo la stessa funzionalità di input sul posto a qualsiasi applicazione in esecuzione in Windows XP Tablet PC Edition 2005 o versione successiva senza la necessità di codice aggiuntivo. Questo articolo sull'uso dell'oggetto PenInputPanel viene fornito per garantire la compatibilità con le versioni precedenti. Le applicazioni che già utilizzano l'oggetto PenInputPanel funzioneranno allo stesso modo, ad eccezione del fatto che il pannello di input verrà visualizzato invece di PenInputPanel quando l'applicazione viene eseguita in Windows XP Tablet PC Edition 2005 o versione successiva.

Se si sviluppa una nuova applicazione per tablet PC e si vuole avere una soluzione di input utente sul posto, il pannello di input fornisce automaticamente questa opzione in Windows XP Tablet PC Edition 2005 o versione successiva. Non è necessario creare un'istanza dell'oggetto PenInputPanel .

Disabilitazione del pannello di input

In alcuni casi può essere necessario disabilitare il pannello di input. È possibile ottenere questo risultato in due modi. A tale scopo, è possibile impostare una voce del Registro di sistema che disabilita il pannello di input per l'intera applicazione.

Disabilitazione del pannello di input a livello di codice

Per disabilitare il pannello di input a livello di codice, creare un'istanza di PenInputPanel e impostarne la proprietà AutoShow su 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;
}

Per disabilitare il pannello di input per più controlli in una singola applicazione, creare un'istanza di un oggetto PenInputPanel per ogni controllo e impostare la proprietà AutoShowsu False per ogni controllo o creare un'istanza di un singolo PenInputPanel e spostarla dal controllo al controllo quando cambia lo stato attivo di input. Per altre informazioni su queste due tecniche, vedi l'argomento PenInputPanel Sample .

Disabilitazione del pannello di input tramite il Registro di sistema

È possibile impostare una voce del Registro di sistema per disabilitare il Pannello di input per l'intera applicazione. Tuttavia, verrà disabilitata anche per le finestre di dialogo comuni, ad esempio la finestra di dialogo Apri file , la finestra di dialogo Stampa e la finestra di dialogo Salva file . Ciò può rendere l'esperienza utente nell'applicazione incoerente con altre applicazioni Tablet PC.

L'impostazione della chiave del DisableInPlace Registro di sistema su zero impedisce la visualizzazione dell'interfaccia utente del pannello di input in un'applicazione. È necessario inserire la chiave del DisableInPlace Registro di sistema in HKEY_LOCAL_MACHINE\Software\Microsoft\TabletTip\. Aggiungere quindi un nuovo valore del Registro di sistema usando il percorso completo dell'applicazione in cui si vuole disabilitare il pannello di input. La voce del Registro di sistema di esempio seguente disabilita il pannello di input in un'applicazione denominata MyApp:

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

Se si verifica ancora un problema nell'applicazione dopo aver disabilitato l'interfaccia utente del pannello di input, potrebbe essere necessario disabilitare il framework sottostante, che esegue una query sull'applicazione per il percorso del cursore. Ad esempio, il pannello di input può esporre un bug nel codice di rilevamento del cursore dell'applicazione. La disattivazione della query di rilevamento del cursore impedisce anche la visualizzazione dell'interfaccia utente del pannello di input. Per disabilitare il framework, impostare la chiave del EnableCaretTracking Registro di sistema su zero. Individuare questa chiave in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\AppCompatFlags\CaretTracking\.

Nota

Gli strumenti di accessibilità e la tecnologia di riconoscimento vocale in Windows XP usano anche questo framework, pertanto la disabilitazione della query disabilita anche queste funzionalità nell'applicazione.

 

Pannello di input e pagine Web

Per usare un'API in una pagina Web, deve funzionare in un ambiente parzialmente attendibile. Tutti i membri della classe PenInputPanel richiedono l'attendibilità totale, ad eccezione del seguente:

Queste API funzionano in un ambiente parzialmente attendibile, ad esempio una pagina Web, consentendo di creare un'istanza di un oggetto PenInputPanel , associarla a un controllo e disabilitare il pannello di input per tale controllo. Per altre informazioni, vedere Programmazione del pannello di input tramite la classe PenInputPanel e l'input penna sul Web.

Oggetto PenInputPanel

Il resto di questo argomento descrive come usare l'oggetto PenInputPanel nelle applicazioni abilitate per Tablet PC. In particolare, questo argomento fa riferimento all'oggetto PenInputPanel quando si discute dell'oggetto di programmazione, del pannello di input della penna quando si fa riferimento all'elemento dell'interfaccia utente e al pannello di input del PC (o pannello di input) quando si fa riferimento al pannello di input globale in genere presente sul lato dello schermo del Tablet PC.

Le sezioni seguenti descrivono l'oggetto PenInputPanel e l'interfaccia utente.