Metodo IPenInputPanel::EnableTsf (peninputpanel.h)

Articolo
08/25/2023

[ PenInputPanel è stato sostituito dal pannello di input di testo (TIP).]

Deprecato. Ottiene o imposta un valore booleano che indica se l'oggetto PenInputPanel tenta di inviare testo al controllo collegato tramite Text Services Framework (TSF) e abilita l'uso dell'interfaccia utente di correzione .

Sintassi

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

Parametri

Enable

TRUE se l'oggetto PenInputPanel deve tentare di inviare testo al controllo collegato usando TSF e che l'interfaccia utente di correzione deve essere abilitata; in caso contrario FALSE. Il valore predefinito è TRUE.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_UNEXPECTED	Parametro o tipo di proprietà imprevisto.
E_NOINTERFACE	Le interfacce TSF non sono esposte sul controllo collegato.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Chiamando questo metodo con Enable impostato su TRUE , l'oggetto PenInputPanel tenta di avviare il TSF nel controllo collegato.

EnableTsf deve essere usato per abilitare PenInputPanel per usare il contesto di inserimento TSF anziché la funzione SendInput per inviare i risultati del riconoscimento della grafia al controllo. Il risultato è che il testo può essere inserito anche se il campo non ha più lo stato attivo.

Quando si chiama EnableTsf con un valore TRUE, l'oggetto PenInputPanel invia un messaggio EM_SETEDITSTYLE al controllo collegato. Se il controllo non supporta questo messaggio, i risultati potrebbero essere imprevedibili. Il controllo InkEdit supporta TSF.

Supporto per le applicazioni legacy

Il supporto è stato aggiunto a TSF e Microsoft Windows per fornire un'interfaccia utente coerente per tutte le applicazioni nel desktop. Questo nuovo supporto consente alle applicazioni o ai controlli legacy che non sono consapevoli del TSF di sfruttare gratuitamente alcuni servizi di testo avanzati. Ad esempio, la dettatura vocale e la grafia possono ora essere usate per immettere testo in un documento in qualsiasi applicazione.

Questa nuova funzionalità è disponibile e abilitata per impostazione predefinita in Windows XP Tablet PC Edition. Per abilitarlo o disabilitarlo:

In Pannello di controllo fare clic su Opzioni internazionali e di lingua.
Nella scheda Lingue fare clic su Dettagli.
Nella scheda Avanzate della finestra di dialogo Servizi di testo e Lingue di input selezionare o deselezionare Estensione del supporto di servizi di testo avanzati a tutti i programmi.

In caso di esito positivo, il testo viene inviato al controllo collegato tramite TSF. Inoltre, se il controllo supporta TSF (e non riceve semplicemente testo da TSF solo perché i servizi di testo avanzati sono stati abilitati per tutti i programmi in Pannello di controllo come indicato in precedenza), l'interfaccia utente di correzione viene visualizzata nel controllo e consente l'accesso alle alternative di scrittura. Chiamando questo metodo con Enable impostato su FALSE , l'oggetto PenInputPanel tenta di arrestare TSF nel controllo collegato.

Requisiti


Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	peninputpanel.h
Libreria	InkObj.dll

Vedi anche

IPenInputPanel

Peninputpanel

Share via