Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Actualización: noviembre 2007
Obsoleto. Indica si el objeto PenInputPanel intenta o no enviar el texto al control asociado a través de Text Services Framework (TSF) y habilita el uso de la interfaz de usuario de corrección. PenInputPanel se ha reemplazado por Microsoft.Ink.TextInput.
Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)
Sintaxis
'Declaración
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Sub EnableTsf ( _
enable As Boolean _
)
'Uso
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
)
Parámetros
- enable
Tipo: System.Boolean
Variable booleana que indica si el objeto PenInputPanel intenta o no enviar el texto al control asociado a través de Text Services Framework (TSF) y habilita el uso de la interfaz de usuario de corrección.
Si es true, el objeto PenInputPanel intenta enviar el texto al control asociado a través de Text Services Framework (TSF) y se habilita la interfaz de usuario de corrección.
Si es false, el objeto PenInputPanel intenta deshabilitar TSF en el control asociado. La interfaz de usuario de corrección no está disponible.
Comentarios
Si se llama a este método con el parámetro enable establecido en true, el objeto PenInputPanel intenta iniciar TSF en el control asociado.
Nota
Se ha agregado compatibilidad a TSF para proporcionar una interfaz de usuario coherente para todas las aplicaciones del escritorio. Esta nueva compatibilidad habilita aplicaciones heredadas o controles que no conocen TSF para sacar partido de algunos servicios de texto avanzados. Por ejemplo, el dictado de voz y la escritura a mano se pueden usar ahora para escribir el texto en un documento en cualquier aplicación.
Esta nueva característica está disponible y habilitada de forma predeterminada en Microsoft® Windows® XP Tablet PC Edition. Para habilitar o deshabilitar la característica:
1. En Panel de control, haga clic en Configuración regional y de idioma.
2. En la ficha Idiomas, haga clic en Detalles.
3. En la ficha Avanzadas del cuadro de diálogo Servicios de texto e idiomas de entrada, active o desactive la casilla Extender compatibilidad de servicios de texto avanzados a todos los programas.
Si se realiza correctamente, el texto se envía al control asociado a través de TSF. Además, si el control admite TSF (y no está recibiendo texto de TSF solamente porque los servicios de texto avanzados están habilitados, como en el procedimiento anterior), la interfaz de usuario de corrección aparece en el control con acceso a alternativas a la escritura a mano. Si se llama a este método con el parámetro enable establecido en false, el objeto PenInputPanel intenta deshabilitar TSF en el control asociado.
Use el método EnableTsf para que PenInputPanel pueda usar el contexto de inserción de TSF en lugar de la función SendInput para enviar los resultados del reconocimiento de escritura a mano al control. Al permitir a PenInputPanel que use el contexto de inserción de TSF, el texto se puede insertar incluso si el campo ya no tiene el foco.
Al llamar a este método con el parámetro enable establecido en true, el objeto PenInputPanel envía un mensaje EM_SETEDITSTYLE al control asociado. Si el control no admite este mensaje, los resultados pueden ser imprevisibles.
El control InkEdit admite TSF.
.gif "Nota de seguridad") Nota de seguridad: |
|---|
Si se usa en entornos de confianza parcial, este método necesita el permiso SecurityPermissionFlag.AllFlags, además de los permisos que requiere PenInputPanel. Vea Security and Trust para obtener más información. |
Ejemplos
En este ejemplo de C# se asocia un objeto PenInputPanel, thePenInputPanel, a un control InkEdit, theInkEdit. Se llama al método EnableTsf en PenInputPanel para iniciar 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);
En este ejemplo de Microsoft Visual Basic® .NET se asocia un objeto PenInputPanel, thePenInputPanel, a un control InkEdit, theInkEdit. Se llama al método EnableTsf en PenInputPanel para iniciar 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)
Plataformas
Windows Vista
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Información de versión
.NET Framework
Compatible con: 3.0