Condividi tramite


Metodo PenInputPanel.EnableTsf

Aggiornamento: novembre 2007

Obsoleto. Indica se l'oggetto PenInputPanel tenta di inviare un testo al controllo associato tramite Framework servizi di testo (TSF) e consente l'utilizzo dell'interfaccia utente di correzione. L'oggetto PenInputPanel è stato sostituito dall'oggetto Microsoft.Ink.TextInput.

Spazio dei nomi:  Microsoft.Ink
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Sub EnableTsf ( _
    enable As Boolean _
)
'Utilizzo
Dim instance As PenInputPanel
Dim enable As Boolean

instance.EnableTsf(enable)
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public void EnableTsf(
    bool enable
)
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public:
void EnableTsf(
    bool enable
)
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public void EnableTsf(
    boolean enable
)
public function EnableTsf(
    enable : boolean
)

Parametri

  • enable
    Tipo: System.Boolean
    Variabile booleana che indica se l'oggetto PenInputPanel tenta di inviare un testo al controllo associato tramite Framework servizi di testo (TSF) e consente l'utilizzo dell'interfaccia utente di correzione.
    Se true, l'oggetto PenInputPanel tenta di inviare un testo al controllo associato tramite Framework servizi di testo (TSF) e l'interfaccia utente di correzione è attivata.
    Se false, l'oggetto PenInputPanel tenta di disattivare TSF sul controllo associato. L'interfaccia utente di correzione non è disponibile.

Note

Quando si chiama questo metodo con il parametro enable impostato su true, l'oggetto PenInputPanel tenta di avviare TSF sul controllo associato.

Nota

Sono stati aggiunti il supporto di TSF e la possibilità di disporre di un'interfaccia utente coerente per tutte le applicazioni del desktop. Questo nuovo supporto abilita applicazioni o controlli legacy che non riconoscono TSF per sfruttare alcuni servizi di testo avanzati. Ad esempio, ora è possibile utilizzare la dettatura e la grafia per immettere un testo in un documento all'interno di qualsiasi applicazione.

Questa nuova funzionalità è disponibile e viene attivata per impostazione predefinita su Microsoft® Windows® XP Tablet PC Edition. Per attivare o disattivare la funzionalità:

1. Nel Pannello di controllo, fare clic su Opzioni internazionali e della lingua.

2. Nella scheda Lingue, fare clic su Dettagli.

3. Nella scheda Avanzate della finestra di dialogo Servizi di testo e lingue di input, selezionare o deselezionare Estendi supporto servizi di testo avanzati a tutte le applicazioni.

In caso di esito positivo, il testo viene inviato al controllo associato tramite TSF. Inoltre, se il controllo supporta TSF (e non sta ricevendo il testo da TSF solo perché i servizi di testi avanzati sono attivati, come nella procedura precedente), l'interfaccia utente di correzione viene visualizzata nel controllo con accesso alle alternative della grafia. Quando si chiama questo metodo con il parametro enable impostato su false, l'oggetto PenInputPanel tenta di disattivare TSF sul controllo associato.

Utilizzare il metodo EnableTsf per consentire all'oggetto PenInputPanel di utilizzare il contesto di inserimento TSF piuttosto che l'oggetto SendInput Function per inviare i risultati del riconoscimento della grafia al controllo. Consentendo all'oggetto PenInputPanel di utilizzare il contesto di inserimento TSF, il testo può essere inserito anche se il campo non dispone più dello stato attivo.

Quando si chiama questo metodo con il parametro enable impostato su true, l'oggetto PenInputPanel invia un messaggio EM_SETEDITSTYLE al controllo associato. Se il controllo non supporta questo messaggio, i risultati potrebbero essere imprevedibili.

Il controllo InkEdit supporta TSF.

ms569656.alert_security(it-it,VS.90).gifNota sulla sicurezza:

Se utilizzato in attendibilità parziale, questo metodo richiede l'autorizzazione SecurityPermissionFlag.AllFlags, oltre alle autorizzazioni richieste dall'oggetto PenInputPanel. Per ulteriori informazioni, vedere Security and Trust.

Esempi

In questo esempio di C# viene associato un oggetto PenInputPanel, thePenInputPanel, a un controllo InkEdit, theInkEdit. Il metodo EnableTsf viene chiamato sull'oggetto PenInputPanel per avviare TSF.

[C#]

// Declare, create, and attach a new
// PenInputPanel to an InkEdit control.
PenInputPanel thePenInputPanel = new PenInputPanel(theInkEdit);

// Start the Text Services Framework
thePenInputPanel.EnableTsf(true);

In questo esempio di Microsoft Visual Basic® .NET viene associato un oggetto PenInputPanel, thePenInputPanel, a un controllo InkEdit, theInkEdit. Il metodo EnableTsf viene chiamato sull'oggetto PenInputPanel per avviare TSF.

[Visual Basic]

'Declare, create, and attach a new
'PenInputPanel to an InkEdit control.
Dim thePenInputPanel As New PenInputPanel(theInkEdit)

'Start the Text Services Framework
thePenInputPanel.EnableTsf(True)

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

PenInputPanel Classe

Membri PenInputPanel

Spazio dei nomi Microsoft.Ink