Compartilhar via

InkPresenter.ActivateCustomDrying Método

  • Referência

Definição

Namespace:
Windows.UI.Input.Inking
Editar

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.

Aplica-se a

Confira também