InkPresenter.ActivateCustomDrying Método

Definição

Namespace:

Windows.UI.Input.Inking

Indica que seu aplicativo requer controle completo da renderização de entrada à tinta.

Por padrão, a entrada de tinta é processada em um thread em segundo plano e renderizada como "molhada" conforme é desenhada. Quando o traço é concluído (caneta ou dedo levantado ou botão do mouse liberado), o traço é processado no thread da interface do usuário e renderizado "seco" para a camada de renderização (acima do conteúdo do aplicativo e substituindo a tinta molhada).

Modelos de hospedagem do InkPresenter

InkCanvas

Chamar ActivateCustomDrying (antes de o InkCanvas ser carregado) faz com que um aplicativo crie um objeto InkSynchronizer para personalizar como um traço de tinta é renderizado como seco para um SurfaceImageSource ou VirtualSurfaceImageSource. Por exemplo, um traço de tinta poderia ser rasterizado e integrado no conteúdo de um aplicativo em vez de uma camada InkCanvas separada.

InkDesktopHost (Windows 10 versão 1511 e mais recente)

Os aplicativos Win32 podem hospedar um InkPresenter em um InkDesktopHost usando a árvore visual DirectComposition.

Isso requer um objeto IInkD2DRenderer para gerenciar a entrada de tinta (consulte o exemplo de tinta complexa).

CoreInkPresenterHost (Windows 10 Fall Creators Update e mais recente)

Hospede um InkPresenter em seu próprio Windows.UI.Árvore de composição sem um controle InkCanvas associado.

public:
 virtual InkSynchronizer ^ ActivateCustomDrying() = ActivateCustomDrying;

InkSynchronizer ActivateCustomDrying();

public InkSynchronizer ActivateCustomDrying();

function activateCustomDrying()

Public Function ActivateCustomDrying () As InkSynchronizer

Retornos

InkSynchronizer

O objeto usado para renderização de traço de tinta personalizada.

Comentários

Códigos do Erro

E_ILLEGAL_METHOD_CALL (0x8000000E)

Gerado se ActivateCustomDrying for chamado depois que InkCanvas for carregado.

Esse método deve ser chamado antes de carregar o InkCanvas.

Secagem personalizada e InkToolbar
Por padrão, a entrada de tinta é processada em um thread em segundo plano e renderizada como "molhada" conforme é desenhada. Quando o traço está concluído (caneta ou dedo param de pressionar ou botão do mouse é liberado), o traço é processado do thread de interface do usuário e renderizado como "seco" na camada InkCanvas (acima do conteúdo do aplicativo e substituindo a tinta molhada). A plataforma de tinta permite substituir esse comportamento e personalizar completamente a experiência de escrita à tinta secando de forma personalizada a entrada de tinta.

Se o aplicativo substituir o comportamento de renderização de tinta padrão do InkPresenter com uma implementação de secagem personalizada, os traços de tinta renderizados não estarão mais disponíveis para o InkToolbar e os comandos de apagamento internos do InkToolbar não funcionarão conforme o esperado. Para oferecer uma funcionalidade de exclusão, você deve lidar com todos os eventos de ponteiro, realizar o teste de clique em cada traço e substituir o comando "Apagar toda a tinta" interno.

Para saber mais sobre a secagem personalizada, veja Windows Ink e interações de caneta em aplicativos UWP.

Confira também

• Interações por caneta
• Introdução: oferecer suporte à tinta em seu aplicativo UWP
• Exemplo de análise de tinta (básico) (C#)
• Exemplo de reconhecimento de manuscrito à tinta (C#)
• Salvar e carregar traços de tinta de um arquivo ISF (Ink Serialized Format)
• Salvar e carregar traços de tinta da área de transferência
• Exemplo de localização e orientação da barra de ferramentas de tinta (básico)
• Exemplo de localização e orientação da barra de ferramentas de tinta (dinâmico)
• Exemplo de livro de colorir
• Exemplo de anotações da família
• Exemplo de escrita à tinta (JavaScript)
• Exemplo de escrita à tinta simples (C#/C++)
• Exemplo de escrita à tinta complexa (C++)
• Exemplo de análise de tinta