Windows.UI.Input.Inking Namespace
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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:
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:
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:
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
- 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