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 |
|
Biblioteca |
|