Classe InkDisp

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

O InkDisp tem estes tipos de membros:

• Eventos
• Interfaces
• Métodos
• Propriedades

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