Partilhar via


Windows.UI.Input.Inking Namespace

Fornece suporte de entrada, processamento e gerenciamento para aplicativos Windows Ink. Isso inclui:

  • Traços de tinta de desenho.
  • Capturando traços.
  • Renderizando traços.
  • Selecionando traços.
  • Excluindo traços.
  • Salvando e carregando traços.
  • Convertendo traços em texto por meio do reconhecimento de manuscrito.
  • Copiar e colar traços da área de transferência.
  • Teste de clique (ou direcionamento de traço).

Classes

InkDrawingAttributes

Fornece propriedades associadas ao desenho de um InkStroke.

InkDrawingAttributesPencilProperties

Fornece um conjunto de propriedades estáticas inkDrawingAttributes para renderizar um traço de lápis em um InkCanvas.

Obtenha uma instância dessa classe chamando InkDrawingAttributes.CreateForPencil e acessando InkDrawingAttributes.PencilProperties.

InkInputConfiguration

Gerencia quais tipos de entrada secundária podem ser processados pelo objeto InkPresenter .

InkInputProcessingConfiguration

Gerencia como a entrada é processada pelo objeto InkPresenter .

InkManager

Observação

Para o aplicativo Universal do Windows usando XAML (Extensible Application Markup Language), recomendamos usar InkPresenter e o controle InkCanvas em vez de InkManager.

Gerencia a entrada, a manipulação e o processamento (incluindo o reconhecimento de manuscrito) de um ou mais objetos InkStroke .

InkModelerAttributes

Gerencia quais tipos de atributos de modelador de tinta podem ser processados pelo objeto InkPresenter .

InkPoint

Fornece dados de entrada brutos para um único ponto usado na construção de um InkStroke.

InkPresenter

Fornece propriedades, métodos e eventos para gerenciar a entrada, o processamento e a renderização de entrada à tinta (padrão e modificado) para um controle InkCanvas .

InkPresenterProtractor

Representa um estêncil visual, na forma de um prolongador para arcos de desenho e curvas, exibido como uma sobreposição semitransparente em um InkCanvas.

O estêncil transforma como um traço de tinta é renderizado:

  • Ele ajusta o traço de tinta à borda do estêncil se a ponta da caneta estiver dentro de um limite de distância (sarjeta).
  • Ele atua como uma máscara e impede o desenho de um traço de tinta dentro da área obscurecida pelo estêncil.

O InkPresenterRuler pode ser manipulado programaticamente e pelo usuário. Ele também é dimensionado e traduzido com o InkCanvas.

InkPresenterRuler

Representa um estêncil visual, na forma de uma regra reta para desenhar linhas retas, exibido como uma sobreposição semitransparente em um InkCanvas.

O estêncil transforma como um traço de tinta é renderizado:

  • Ele ajusta o traço de tinta à borda do estêncil se a ponta da caneta estiver dentro de um limite de distância (sarjeta).
  • Ele atua como uma máscara e impede o desenho de um traço de tinta dentro da área obscurecida pelo estêncil.

O InkPresenterRuler pode ser manipulado programaticamente e pelo usuário. Ele também é dimensionado e traduzido com o InkCanvas.

InkRecognitionResult

Fornece propriedades e métodos para gerenciar dados de reconhecimento de manuscrito inkStroke .

Os resultados do reconhecimento são produzidos para cada palavra detectada por um InkRecognizer.

InkRecognizer

Gerencia todos os aspectos do reconhecimento de manuscrito.

InkRecognizerContainer

Fornece propriedades e métodos para gerenciar um ou mais objetos InkRecognizer usados para reconhecimento de manuscrito.

InkRecognizerContainer será nulo se um mecanismo de reconhecimento não estiver disponível no sistema.

InkStroke

Um único traço de tinta, incluindo os parâmetros de curva de Bézier usados para renderização final do traço.

InkStrokeBuilder

Cria traços de entrada de ponteiro bruto.

Observação

Para o aplicativo Universal do Windows usando XAML (Extensible Application Markup Language), recomendamos usar InkPresenter e o controle InkCanvas em vez de InkManager.

Use CreateStrokeFromInkPoints e SetDefaultDrawingAttributes para criar traços programaticamente para um InkPresenter.

InkStrokeContainer

Fornece propriedades e métodos para armazenar e gerenciar a coleção de objetos InkStroke renderizados pelo InkPresenter.

As modificações feitas em qualquer um dos traços de tinta no contêiner de traço são renderizadas imediatamente na superfície de desenho associada ao InkPresenter.

InkStrokeInput

Fornece propriedades e eventos para StrokeInput associados a um objeto InkPresenter .

InkStrokeRenderingSegment

Um único segmento de um traço de tinta completo.

Um único segmento consiste em um ponto de partida, um ponto final e dois pontos de controle Bezier. No entanto, para uma série de segmentos que compõem um traço, o último ponto do segmento anterior é o primeiro ponto do segmento atual. Isso significa que apenas o ponto final para cada segmento é necessário para representar um traço completo.

Cada traço é um vetor de objetos InkStrokeRenderingSegment com o primeiro segmento identificado por um único ponto de partida e todos os segmentos restantes identificados por um ponto final e dois pontos de controle Bezier.

InkStrokesCollectedEventArgs

Contém dados de evento para o evento StrokesCollected do InkPresenter associado a um controle InkCanvas .

Por padrão, um traço de tinta é processado em um thread de fundo de baixa latência e renderizado molhado à medida que é desenhado. 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 InkCanvas (acima do conteúdo do aplicativo). Se o thread da interface do usuário estiver ocupado, mais de um traço de tinta poderá ser processado (coletado) quando o thread ficar disponível.

Esse comportamento pode ser substituído chamando o método ActivateCustomDrying antes de carregar o InkCanvas.

InkStrokesErasedEventArgs

Contém dados de evento para o evento StrokesErased do InkPresenter associado a um controle InkCanvas .

Por padrão, os dados de traço de tinta e a renderização são gerenciados inteiramente pelo controle InkCanvas . No entanto, esse comportamento pode ser substituído chamando o método ActivateCustomDrying antes de carregar o InkCanvas.

InkSynchronizer

Gerencia a sincronização da entrada à tinta e fornece métodos para renderizá-la no contexto do dispositivo Direct2D do aplicativo Universal do Windows, em vez do controle InkCanvas padrão. Isso requer um objeto IInkD2DRenderer para gerenciar a entrada de tinta (consulte o exemplo de tinta complexa).

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).

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.

InkUnprocessedInput

Fornece propriedades e eventos para processamento personalizado de dados de tinta de um controle InkCanvas . Os dados não são processados pelo InkPresenter.

Use InkInputProcessingConfiguration para identificar os dados a serem passados como UnprocessedInput.

PenAndInkSettings

Fornece acesso às configurações do usuário relacionadas à aceitação e conversão de tinta em entrada de texto em um controle de texto (quando HandwritingView está habilitado).

Interfaces

IInkPointFactory

Define a implementação de um tipo que gera objetos InkPoint usados na construção de um InkStroke.

IInkPresenterRulerFactory

Define a implementação de um tipo que gera objetos InkPresenterRuler usados na construção de um InkPresenter.

IInkPresenterStencil

Representa um estêncil visual, exibido como uma sobreposição semitransparente em um InkCanvas.

O estêncil transforma como um traço de tinta é renderizado:

  • Ele ajusta o traço de tinta à borda do estêncil se a ponta da caneta estiver dentro de um limite de distância (sarjeta).
  • Ele atua como uma máscara e impede o desenho de um traço de tinta dentro da área obscurecida pelo estêncil.

O estêncil pode ser manipulado programaticamente e pelo usuário. Ele também é dimensionado e traduzido com o InkCanvas.

IInkRecognizerContainer

Representa um ou mais objetos InkRecognizer .

IInkStrokeContainer

Representa um gerente para a coleção de objetos InkStroke renderizados pelo InkPresenter.

As modificações feitas em qualquer um dos traços de tinta no contêiner de traço são renderizadas imediatamente na superfície de desenho associada ao InkPresenter.

Enumerações

HandwritingLineHeight

Especifica o espaço de manuscrito disponível ao usar tinta para entrada de texto em um controle de texto (quando o HandwritingView está habilitado).

InkDrawingAttributesKind

Especifica o tipo de InkDrawingAttributes associado ao InkStroke.

InkHighContrastAdjustment

Especifica como o objeto InkPresenter manipula a entrada (padrão e modificada) do controle InkCanvas associado quando o sistema está no modo de alto contraste.

InkInputProcessingMode

Especifica como o objeto InkPresenter interpreta a entrada de seu controle InkCanvas associado.

Por padrão, a entrada é tratada como traços padrão de tinta ou apagamento, ou pode ser passada como UnprocessedInput para seu aplicativo para processamento personalizado.

InkInputRightDragAction

Especifica como o objeto InkPresenter manipula a entrada secundária de um botão de barril de caneta, dica de borracha de caneta, botão direito do mouse ou semelhante.

Por padrão, essa entrada secundária é processada como entrada primária e renderizada como um InkStroke (consulte comentários).

InkManipulationMode

Especifica os modos de entrada à tinta.

InkPersistenceFormat

Especifica os formatos para salvar a entrada de tinta.

InkPresenterPredefinedConfiguration

Especifica o comportamento de escrita à tinta de um ou mais pontos de contato. Usado com SetPredefinedConfiguration.

InkPresenterStencilKind

Especifica o tipo de estêncil que pode ser exibido em um InkCanvas.

InkRecognitionTarget

Indica quais traços você deseja incluir no reconhecimento de manuscrito.

PenHandedness

Identifica a mão de escrita preferencial, conforme especificado pelo usuário em Configurações -> Dispositivos -> Caneta & Windows Ink -> Escolha com qual mão você escreve.

PenTipShape

Identifica a forma da Dica de Caneta.

Confira também