InkPresenter.ActivateCustomDrying Método

Definición

Espacio de nombres:

Windows.UI.Input.Inking

Indica que la aplicación requiere un control completo de la representación de entrada de lápiz.

De manera predeterminada, la entrada de lápiz se procesa en un subproceso en segundo plano de baja latencia y se representa como "húmeda" mientras se dibuja. Cuando se completa el trazo (lápiz o dedo quitado o botón del mouse), el trazo se procesa en el subproceso de la interfaz de usuario y se representa "seco" en la capa de representación (encima del contenido de la aplicación y reemplazando la tinta húmeda).

Modelos de hospedaje de InkPresenter

InkCanvas

Al llamar a ActivateCustomDrying (antes de cargar InkCanvas), una aplicación crea un objeto InkSynchronizer para personalizar la representación de un trazo de lápiz seco en la clase SurfaceImageSource o VirtualSurfaceImageSource. Por ejemplo, un trazo de lápiz se puede rasterizar e integrar en el contenido de la aplicación, en lugar de hacerlo como una capa de InkCanvas diferente.

InkDesktopHost (Windows 10, versión 1511 y posteriores)

Las aplicaciones Win32 pueden hospedar un InkPresenter en un inkDesktopHost mediante el árbol visual DirectComposition.

Esto requiere un objeto IInkD2DRenderer para administrar la entrada de lápiz (vea el ejemplo de entrada de lápiz compleja).

CoreInkPresenterHost (Windows 10 Fall Creators Update y versiones más recientes)

Hospede un InkPresenter en su propio Windows.UI.Árbol de composición sin un control InkCanvas asociado.

public:
 virtual InkSynchronizer ^ ActivateCustomDrying() = ActivateCustomDrying;

InkSynchronizer ActivateCustomDrying();

public InkSynchronizer ActivateCustomDrying();

function activateCustomDrying()

Public Function ActivateCustomDrying () As InkSynchronizer

Devoluciones

InkSynchronizer

Objeto utilizado para la representación personalizada de trazos de lápiz.

Comentarios

Códigos de error

E_ILLEGAL_METHOD_CALL (0x8000000E)

Se produce si se llama a ActivateCustomDrying después de cargar InkCanvas .

Se debe llamar a este método antes de cargar InkCanvas.

Secado personalizado y InkToolbar
De manera predeterminada, la entrada de lápiz se procesa en un subproceso en segundo plano de baja latencia y se representa como "húmeda" mientras se dibuja. Cuando se completa el trazo (se levanta el lápiz o el dedo o se libera el botón del mouse), el trazo se procesa en el subproceso de la interfaz de usuario y se representa como "seco" en la capa de InkCanvas (lo verás sobre el contenido de la aplicación y reemplazando la entrada de lápiz húmeda). La plataforma de entrada de lápiz te permite invalidar este comportamiento y personalizar totalmente la experiencia de entrada de lápiz mediante el secado personalizado de la entrada de lápiz.

Si la aplicación invalida el comportamiento de representación de entrada de lápiz predeterminada de InkPresenter con una implementación de secado personalizada, los trazos de lápiz representados ya no están disponibles para InkToolbar y los comandos de borrado integrados de InkToolbar no funcionan según lo previsto. Para proporcionar la funcionalidad de borrado, debes controlar todos los eventos de puntero, realizar la prueba de posicionamiento en cada trazo e invalidar el comando "Borrar todas las entradas de lápiz" integrado.

Para obtener más información sobre el secado personalizado, consulta Interacciones de lápiz y Windows Ink en aplicaciones para UWP.

Consulte también

• Interacciones de pluma y lápiz
• Introducción: Compatibilidad con la entrada de lápiz en la aplicación para UWP
• Ejemplo de análisis de entrada de lápiz (básico) (C#)
• Ejemplo de reconocimiento de escritura a mano de lápiz (C#)
• Guardar y cargar trazos de lápiz desde un archivo de formato serializado de entrada de lápiz (ISF)
• Guardar y cargar trazos de lápiz desde el Portapapeles
• Ejemplo de orientación y ubicación de la barra de herramientas de entrada de lápiz (básico)
• Ejemplo de orientación y ubicación de la barra de herramientas de entrada de lápiz (dinámica)
• Muestra de libro para colorear
• Muestra de notas familiares
• Ejemplo de entrada manuscrita (JavaScript)
• Ejemplo de entrada manuscrita simple (C#/C++)
• Ejemplo de entrada manuscrita compleja (C++)
• Ejemplo de análisis de entrada de lápiz