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.
.gif "Nota sulla sicurezza") Nota 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