Compartilhar via


Referência de controle InkPicture

O controle InkPicture fornece a capacidade de colocar uma imagem em um aplicativo e permitir que os usuários adicionem tinta sobre ela. Destina-se a cenários em que a tinta não é reconhecida como texto, mas é armazenada como tinta.

O controle InkPicture pode ser instanciado chamando o método CoCreateInstance em C++.

Observação

O controle InkPicture não está marcado como seguro para scripts. O controle InkPicture não deve ser usado em páginas HTML ou ASP.NET.

Criar o controle InkPicture por trás de um controle transparente (como um GroupBox com o conjunto de propriedades WS_EX_TRANSPARENT) impedirá inkPicture de coletar tinta.

Membros

Enumeração Descrição
InkPictureSizeMode Define valores que especificam como a imagem de plano de fundo se comporta dentro do controle InkPicture.
Evento Descrição
Changeuicues Preterido.
Clique Ocorre quando um usuário clica no controle InkPicture.
Evento CursorButtonDown Ocorre quando o controle InkCollector detecta um objeto IInkCursorButton que está inativo.
Evento CursorButtonUp Ocorre quando o controle InkPicture detecta um IInkCursorButton que está ativo.
Evento CursorDown Ocorre quando a dica de cursor entra em contato com a superfície do tablet de digitalização.
Evento CursorInRange Ocorre quando um cursor entra no intervalo de detecção física (proximidade) do contexto do tablet.
Evento CursorOutOfRange Ocorre quando o cursor sai do intervalo de detecção física (proximidade) do contexto do tablet.
DblClick Ocorre quando o controle InkPicture é clicado duas vezes.
Esse método de evento é definido na interface _IInkPictureEvents . A interface _IInkPictureEvents implementa a interface IDispatch com um identificador de DISPID_IPEDblClick.
Evento gesture Ocorre quando um gesto de aplicativo é reconhecido.
Evento KeyDown [Controle InkPicture] Ocorre quando uma tecla é pressionada e na posição inferior enquanto o controle InkPicture tem foco.
Evento KeyPress[Controle InkPicture] Ocorre quando uma tecla é pressionada enquanto o controle InkPicture tem foco.
Evento KeyUp [Controle InkPicture] Ocorre quando uma chave é liberada enquanto o controle InkPicture tem foco.
Evento MouseDown [Controle InkPicture] Ocorre quando o ponteiro do mouse está sobre o controle InkPicture e um botão do mouse é pressionado.
Mouseenter Ocorre quando o ponteiro do mouse entra no controle InkPicture.
Mousehover Ocorre quando o ponteiro do mouse passa o mouse sobre o controle InkPicture.
Mouseleave Ocorre quando o ponteiro do mouse deixa o controle InkPicture.
Evento MouseMove [Controle InkPicture] Ocorre quando o ponteiro do mouse é movido sobre o controle InkPicture.
Evento MouseUp [Controle InkPicture] Ocorre quando o ponteiro do mouse está sobre o controle InkPicture e um botão do mouse é liberado.
Mousewheel Ocorre quando a roda do mouse se move enquanto o controle InkPicture tem foco.
Evento NewInAirPackets Ocorre quando um pacote no ar é visto.
Evento NewPackets Ocorre quando o controle InkPicture recebe um pacote.
Pintado Ocorre quando o controle InkPicture concluiu o redesenho em si.
Pintura Ocorre antes que o controle InkPicture se redesenhe.
Redimensionar Ocorre quando o controle InkPicture é redimensionado.
SelectionChanged Ocorre quando a seleção de texto dentro do controle InkPicture é alterada, como por meio de alterações na interface do usuário, procedimentos de recortar e colar ou a propriedade Selection .
Selectionchanging Ocorre quando a seleção de texto dentro do controle InkPicture está prestes a ser alterada, como por meio de alterações na interface do usuário, procedimentos de recortar e colar ou a propriedade Selection .
SelectionMoved Ocorre quando a posição da seleção atual foi alterada, como por meio de alterações na interface do usuário, procedimentos de recortar e colar ou a propriedade Selection .
Evento SelectionMoving [Controle InkPicture] Ocorre quando a posição da seleção atual está prestes a ser alterada, como por meio de alterações na interface do usuário, procedimentos de recortar e colar ou a propriedade Selection .
SelectionResized Ocorre quando o tamanho da seleção atual foi alterado, como por meio de alterações na interface do usuário, procedimentos de recortar e colar ou a propriedade Selection .
Selectionresizing Ocorre quando o tamanho da seleção atual está prestes a ser alterado, como por meio de alterações na interface do usuário, procedimentos de recortar e colar ou a propriedade Selection .
SizeChanged Ocorre após o controle InkPicture ter sido redimensionado, especificamente, depois que o valor da propriedade Width ou Height for alterado.
SizeModeChanged Ocorre depois que a propriedade SizeMode do controle InkPicture foi alterada.
Stylechanged Não implementado.
Curso Ocorre quando o usuário desenha um novo traço em qualquer tablet.
StrokesDeleted Ocorre depois que objetos IInkStrokeDisp foram excluídos da propriedade Ink .
StrokesDeleting Ocorre antes que os objetos IInkStrokeDisp sejam excluídos da propriedade Ink .
Systemcolorschanged Ocorre depois que as cores do sistema mudam.
Systemgesture Ocorre quando um gesto do sistema é reconhecido.
Evento TabletAdded Ocorre quando um tablet é adicionado ao sistema.
Evento TabletRemoved Ocorre quando um tablet é removido do sistema.
Método Descrição
Método GetEventInterest Retorna um valor que indica se o controle InkPicture tem interesse em um evento específico.
GetGestureStatus Retorna um valor que indica se o controle InkPicture tem interesse em um gesto de aplicativo específico.
Método GetWindowInputRectangle Retorna o retângulo da janela, em pixels, no qual a tinta é desenhada.
Hittestselection Retorna um membro da enumeração SelectionHitResult , que especifica qual parte de uma seleção, se houver, foi atingida durante um teste de clique.
Método SetAllTabletsMode Permite que o controle InkPicture colete tinta de qualquer tablet anexado ao Tablet PC.
Método SetEventInterest Define um valor que indica se um controle InkPicture tem interesse em um evento especificado.
SetFocus Move o foco para o controle InkPicture.
Método SetGestureStatus Define o interesse do objeto InkPicture em um gesto de aplicativo especificado.
Método SetSingleTabletIntegratedMode Define o controle InkPicture para coletar tinta de apenas um tablet anexado ao Tablet PC. A tinta de outros tablets é ignorada.
Método SetWindowInputRectangle Especifica o retângulo de janela a ser definido, nas coordenadas da janela, em que a tinta é desenhada.
ShowWhatsThis Exibe um tópico selecionado em um arquivo de Ajuda usando o pop-up "O que é isso" fornecido pela Ajuda em sistemas operacionais Microsoft Windows de 32 bits (somente tempo de design).
Zorder Coloca o controle na parte frontal ou traseira da ordem z dentro de seu nível gráfico (somente tempo de design).
Propriedade Descrição
Propriedade AutoRedraw Obtém ou define um valor que especifica se o controle InkPicture é repintado quando a janela é invalidada (se o objeto InkDisp atualmente associado ao controle InkPicture é redesenhado automaticamente quando a janela associada ao InkPicture recebe uma mensagem WM_PAINT).
Backcolor Obtém ou define a cor da tela de fundo para o controle InkPicture. A cor da tela de fundo padrão é a cor da tela de fundo da janela do sistema, que normalmente é branca.
Propriedade CollectingInk Obtém o valor que especifica se o controle InkPicture está coletando tinta (somente tempo de execução).
Collectionmode Obtém ou define o modo de coleta que determina se tinta, gestos ou tinta e gestos são reconhecidos conforme o usuário grava.
Propriedade Cursors Obtém a coleção IInkCursors disponível para uso na região de escrita à tinta do controle InkPicture.
Customstrokes Obtém a coleção IInkCustomStrokes a ser persistente com a tinta (somente tempo de design).
Propriedade DefaultDrawingAttributes Obtém ou define a coleção Padrão InkDrawingAttributes a ser usada ao desenhar e exibir tinta (somente tempo de execução).
Propriedade DesiredPacketDescription Obtém ou define a descrição do pacote do controle InkPicture (somente tempo de execução).
Propriedade DynamicRendering Obtém ou define o valor que especifica se o controle InkPicture renderiza dinamicamente a tinta conforme ela é coletada.
Editingmode Obtém ou define um valor que especifica se o controle InkPicture está no modo de tinta, no modo de exclusão ou no modo de seleção/edição.
Enabled Obtém ou define um valor que determina se o controle InkPicture pode responder a eventos gerados pelo usuário.
Nota: Essa propriedade é equivalente à propriedade InkEnabled .
EraserMode Obtém ou define o valor que especifica se a tinta é apagada por traço ou por ponto.
EraserWidth Obtém ou define o valor que especifica a largura da ponta da caneta borracha.
Hwnd Obtém o identificador de janela ao qual o controle InkPicture está associado. (somente tempo de execução)
Tinta Obtém ou define o objeto InkDisp associado ao controle InkPicture (somente tempo de execução).
InkEnabled Obtém ou define um valor que especifica se o controle InkPicture coleta entrada de caneta (pacotes no ar, cursor em eventos de intervalo e assim por diante).
Propriedade MarginX Obtém ou define a margem do eixo x ao redor do retângulo da janela nas coordenadas da tela.
Propriedade MarginY Obtém ou define a margem do eixo y ao redor do retângulo da janela nas coordenadas da tela.
Propriedade MouseIcon Obtém ou define o ícone de mouse personalizado atual.
Propriedade MousePointer Obtém ou define um valor que indica o tipo de ponteiro do mouse que aparece quando o mouse está sobre uma parte específica do controle InkPicture.
Imagem Obtém o arquivo gráfico a ser exibido no controle InkPicture.
Propriedade Renderer Obtém ou define o objeto InkRenderer usado para desenhar tinta no controle InkPicture (somente tempo de execução).
Seleção Obtém a coleção InkStrokes selecionada atualmente dentro do controle InkPicture (somente tempo de execução).
SizeMode Obtém ou define como o controle lida com o posicionamento e o dimensionamento da imagem.
Propriedade SupportHighContrastInk Obtém um valor que especifica se a tinta é renderizada como apenas uma cor, Cor = COLOR_WINDOWTEXT (da chamada GetSystemMetrics) quando o sistema está no modo de Alto Contraste.
SupportHighContrastSelectionUI Obtém ou define um valor que especifica se todas as interfaces do usuário de seleção (caixa delimitadora de seleção e identificadores de seleção) são desenhadas em alto contraste quando o sistema está no modo de Alto Contraste.
Propriedade Tablet Obtém o objeto IInkTablet que o controle InkPicture está usando atualmente para coletar entrada.

Comentários

A interface do usuário de tempo de execução para o controle InkPicture é uma janela com uma tela de fundo opaca (cor única, plano de fundo de imagem ou ambos) que contém tinta opaca.

Você pode usar o controle InkPicture para renderizar tinta no Microsoft Windows 2000, Windows Server 2003, qualquer edição do Windows XP que não seja o Windows XP Tablet PC Edition e qualquer versão do Windows Vista. No entanto, você pode inserir tinta, aceitar gestos ou reconhecer manuscrito somente sob as seguintes condições:

  • A tinta poderá ser inserida e reconhecida se o Windows Vista ou o XP Tablet PC Edition 2005 estiver instalado.
  • Gestos também podem ser reconhecidos.
  • A manuscrito poderá ser reconhecida como texto se a manuscrito se originar em computadores que executam versões mais antigas do Windows, desde que os reconhecedores estejam presentes.

Se você usar o Windows 2000, o Windows Server 2003, qualquer edição do Windows XP diferente do Windows XP Tablet PC Edition 2005, poderá atribuir valores às propriedades ambiente do controle InkPicture e copiar e colar tinta para outros aplicativos. No entanto, o valor de sua propriedade InkEnabled sempre será FALSE.

Objetos InkDisp persistentes podem ser carregados e exibidos em todas as edições do Windows Vista e XP e em sistemas que têm apenas o SDK (Kit de Desenvolvimento de Software) windows XP Tablet PC Edition instalado. Objetos InkDisp só podem ser convertidos em texto (reconhecido), se o Windows Vista ou o Windows XP Tablet PC Edition 2005 estiver instalado.

Se as operações nesse controle não forem bem-sucedidas, um HRESULT legal será retornado. Se as condições de erro resultarem, marcar o HRESULT retornado em relação ao erro.

Para obter mais informações sobre controles de tinta, consulte Tinta.

Para obter informações sobre quais threads geram eventos específicos, consulte Threads on Which an Event Can Fire.

Para melhorar o desempenho do aplicativo, descarte manualmente um controle InkPicture quando ele não for mais necessário.

Observação

Quando um controle InkPicture é sobreposto com outro controle, como um GroupBox definido como transparente, o InkPicture não coletará tinta. O InkPicture deve ser o controle mais alto na ordem Z ou deve ser um filho da GroupBox.

Implementação de COM

Esse objeto implementa a interface COM IInkPicture .

Referência de controle InkEdit

Classe InkOverlay