Compartilhar via


Classe InkDisp

Representa os traços coletados de tinta dentro de um espaço à tinta.

O InkDisp tem estes tipos de membros:

Eventos

A classe InkDisp tem esses eventos.

Evento Descrição
Inkadded Ocorre quando um traço é adicionado ao objeto InkDisp .
Inkdeleted Ocorre quando um traço é excluído do objeto InkDisp .

Interfaces

A classe InkDisp define essas interfaces.

Interface Descrição
Iinkdisp Esse objeto implementa a interface COM IInkDisp .

Métodos

A classe InkDisp tem esses métodos.

Método Descrição
AddStrokesAtRectangle Insere uma coleção de traços no objeto InkDisp no retângulo especificado.
Canpaste Indica se iDataObject pode ser convertido em um objeto InkDisp .
Clip Remove partes de um traço ou coleção de traços que estão fora de um retângulo.
ClipboardCopy Copia a coleção InkStrokes para a Área de Transferência.
ClipboardCopyWithRectangle Copia os objetos IInkStrokeDisp contidos no retângulo conhecido para a Área de Transferência.
ClipboardPaste Copia o IDataObject da Área de Transferência para o objeto InkDisp .
Clone Cria um objeto InkDisp duplicado.
CreateStroke Cria um traço de pontos ou dados de pacote.
CreateStrokes Cria uma coleção InkStrokes para este objeto InkDisp .
DeleteStroke Exclui um traço do objeto InkDisp .
DeleteStrokes Exclui traços do objeto InkDisp .
Método ExtractStrokes Extrai traços do objeto InkDisp e retorna um novo objeto InkDisp que contém os traços extraídos.
Método ExtractWithRectangle Corta ou copia traços de um objeto classe InkDisp existente e cola-os em um novo objeto InkDisp Class , usando o retângulo conhecido para determinar quais traços extrair.
GetBoundingBox Recupera a caixa delimitadora de todos os traços no objeto InkDisp .
HitTestCircle Recupera a coleção InkStrokes que está completamente dentro ou interseccionada por um círculo conhecido.
HitTestWithLasso Recupera os traços dentro de uma área de seleção de polilinha.
HitTestWithRectangle Recupera os traços contidos em um retângulo especificado.
Carga Popula um novo objeto InkDisp com dados binários conhecidos.
NearestPoint Recupera o IInkStrokeDisp dentro do objeto InkDisp mais próximo de um ponto conhecido, fornecendo opcionalmente informações adicionais.
Salvar Converte a tinta em um formato especificado e retorna os dados binários.

Propriedades

A classe InkDisp tem essas propriedades.

Propriedade Tipo de acesso Descrição
Customstrokes
Somente leitura
Obtém a coleção IInkCustomStrokes a ser persistida com a tinta.
Sujo
Leitura/gravação
Obtém ou define o valor que indica se um objeto InkDisp foi modificado desde a última vez em que a tinta foi salva.
ExtendedProperties
Somente leitura
Obtém a coleção de dados definidos pelo aplicativo.
Traços
Somente leitura
Obtém a coleção InkStrokes contida no objeto InkDisp .

Comentários

Esse objeto pode ser instanciado chamando o método CoCreateInstance em C++.

Observação

A primeira instanciação desse objeto faz com que o GDI+ também seja instanciado. Um efeito colateral é que, se você estiver usando um único objeto de tinta em um loop e criá-lo e destruí-lo dentro do loop, fará com que o GDI+ seja instanciado várias e mais. Isso pode causar uma degradação de desempenho em seu aplicativo. Para evitar isso, mantenha uma única instância de um objeto de tinta o tempo todo enquanto seu aplicativo estiver usando tinta.

Um objeto InkDisp é um contêiner de dados de traço (ponto). Os dados de traço ou os pontos coletados pela caneta são colocados em um objeto InkDisp . A propriedade Strokes contém os dados de todos os traços dentro do objeto InkDisp .

O objeto InkCollector , o objeto InkOverlay e o controle InkPicture coleta pontos do dispositivo de entrada e os coloca em um objeto InkDisp . Esses objetos agem essencialmente como a origem que distribui tinta em um ou muitos objetos InkDisp diferentes, que atuam como contêineres que contêm a tinta distribuída.

O espaço à tinta é um espaço de coordenadas virtual para o qual as coordenadas do contexto do tablet são mapeadas. Esse espaço é fixo em um sistema de coordenadas HIMETRIC. Em coordenadas de espaço à tinta, uma movimentação de 0 a 1 é igual a 1 unidade HIMETRIC. Esse mapeamento facilita a relação de vários objetos InkDisp .

O objeto InkRenderer gerencia os mapeamentos entre a tinta e a janela de exibição.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
Cabeçalho
Msinkaut.h (também requer Msinkaut_i.c)
Biblioteca
InkObj.dll

Confira também

IInkStrokeDisp Interface

Coleção InkStrokes

IInkTablet Interface