Ler em inglês

Partilhar via

Referência de controle InkPicture

  • Artigo

O controle InkPicture fornece a capacidade de colocar uma imagem em um aplicativo e permitir que os usuários adicionem tinta sobre ele. 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++.

Nota

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 atrás de um controle transparente (como um GroupBox com a propriedade WS_EX_TRANSPARENT definida) impedirá que InkPicture colete 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.
de eventos CursorButtonDown Ocorre quando o controleInkCollector deteta um IInkCursorButton objeto que está inativo.
de eventos CursorButtonUp Ocorre quando o controle InkPicture deteta um IInkCursorButton que está ativo.
Evento CursorDown Ocorre quando a ponta do cursor entra em contato com a superfície do tablet digitalizando.
de eventos CursorInRange Ocorre quando um cursor entra no intervalo de deteção física (proximidade) do contexto do tablet.
de eventos CursorOutOfRange Ocorre quando o cursor sai do intervalo de deteção física (proximidade) do contexto do tablet.
DblClick Ocorre quando o controle InkPicture é clicado duas vezes.
Este método de evento é definido na interface _IInkPictureEvents. A interface _IInkPictureEvents implementa o IDispatch interface com um identificador de DISPID_IPEDblClick.
de eventos de gestos Ocorre quando um gesto de aplicativo é reconhecido.
Evento KeyDown [InkPicture Control] Ocorre quando uma tecla é pressionada e na posição para baixo enquanto o controle InkPicture tem foco.
KeyPress Event[InkPicture Control] Ocorre quando uma tecla é pressionada enquanto o controle InkPicture tem foco.
Evento KeyUp [InkPicture Control] Ocorre quando uma chave é liberada enquanto o controle InkPicture tem foco.
Evento MouseDown [InkPicture Control] 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 sobre o controle InkPicture.
MouseLeave Ocorre quando o ponteiro do mouse deixa o controle InkPicture.
Evento MouseMove [InkPicture Control] Ocorre quando o ponteiro do mouse é movido sobre o controle InkPicture.
Evento MouseUp [InkPicture Control] 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.
de eventos NewInAirPackets Ocorre quando um pacote no ar é visto.
de eventos NewPackets Ocorre quando o controle InkPicture recebe um pacote.
pintado Ocorre quando o controle InkPicture concluiu o próprio redesenho.
Pintura Ocorre antes que o controle InkPicture seja redesenhado.
Redimensionar Ocorre quando o controle InkPicture é redimensionado.
SelectionChanged Ocorre quando a seleção de texto dentro do controle InkPicture foi alterada, como por meio de alterações na interface do usuário, procedimentos de cortar e colar ou a propriedadeSeleção.
SeleçãoAlterando 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 cortar e colar ou a propriedadeSeleção.
SelectionMoved Ocorre quando a posição da seleção atual foi alterada, como por meio de alterações na interface do usuário, nos procedimentos de cortar e colar ou na propriedade Seleção.
SelectionMoving Evento [InkPicture Control] Ocorre quando a posição da seleção atual está prestes a mudar, como por meio de alterações na interface do usuário, procedimentos de cortar e colar ou a propriedade Seleção.
SelectionResized Ocorre quando o tamanho da seleção atual foi alterado, como por meio de alterações na interface do usuário, procedimentos de cortar e colar ou a propriedadeSeleção.
SelectionRedimensionamento Ocorre quando o tamanho da seleção atual está prestes a mudar, como por meio de alterações na interface do usuário, procedimentos de cortar e colar ou a propriedadeSeleção.
SizeChanged Ocorre depois que o controle InkPicture foi redimensionado, especificamente, depois que o valor da propriedade Width ou Height é 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çado em qualquer tablet.
StrokesDeleted Ocorre depois que objetos IInkStrokeDisp foram excluídos da propriedadeInk.
TraçadosExcluindo Ocorre antes que objetos IInkStrokeDisp sejam excluídos da propriedade Ink.
SystemColorsChanged Ocorre após a alteração das cores do sistema.
SystemGesture Ocorre quando um gesto do sistema é reconhecido.
Evento TabletAdded Ocorre quando um tablet é adicionado ao sistema.
de eventos 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, dentro do 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 ocorrência.
Método SetAllTabletsMode Permite que o controle InkPicture colete tinta de qualquer tablet conectado 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 conectado ao Tablet PC. A tinta de outros tablets é ignorada.
Método SetWindowInputRectangle Especifica o retângulo da janela a ser definido, em coordenadas da janela, dentro do qual 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 em tempo de design).
ZOrder Coloca o controle na frente ou atrás da ordem z dentro de seu nível gráfico (somente em tempo de design).
Propriedade Descrição
de propriedade AutoRedraw Obtém ou define um valor que especifica se o controle InkPicture repinta 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 do plano de fundo para o controle InkPicture. A cor de fundo padrão é a cor 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 à medida que o usuário escreve.
Cursors Property Obtém o coleção de IInkCursors disponível para uso na região de tinta do controle InkPicture.
CustomStrokes Obtém o coleção de IInkCustomStrokes a ser persistida com a tinta (somente em tempo de design).
Propriedade DefaultDrawingAttributes Obtém ou define o padrão InkDrawingAttributes coleção 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 à medida que é 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.
Ativado Obtém ou define um valor que determina se o controle InkPicture pode responder a eventos gerados pelo usuário.
Nota: Esta propriedade é equivalente à propriedadeInkEnabled.
EraserMode Obtém ou define o valor que especifica se a tinta é apagada por traçado ou por ponto.
EraserWidth Obtém ou define o valor que especifica a largura da ponta da caneta de borracha.
hWnd Obtém o identificador de janela ao qual o controle InkPicture está vinculado. (apenas tempo de execução)
de 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 in-air, 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 para aparecer no controle InkPicture.
de propriedade do renderizador Obtém ou define o objeto InkRenderer que é usado para desenhar tinta no controle InkPicture (somente tempo de execução).
Seleção Obtém o coleção de InkStrokes atualmente selecionada 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, Color = 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 de usuário de seleção (caixa delimitadora de seleção e alças de seleção) são desenhadas em alto contraste quando o sistema está no modo de Alto Contraste.
Tablet Property 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 um plano de fundo opaco (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 diferente do Windows XP Tablet PC Edition e qualquer versão do Windows Vista. No entanto, você pode inserir tinta, aceitar gestos ou reconhecer a caligrafia somente nas seguintes condições:

  • A tinta pode ser introduzida e reconhecida se o Windows Vista ou XP Tablet PC Edition 2005 estiver instalado.
  • Os gestos também podem ser reconhecidos.
  • A caligrafia pode ser reconhecida como texto se a caligrafia tiver origem em máquinas que executam versões mais antigas do Windows, desde que os reconhecedores estejam presentes.

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

Os objetosInkDisppersistentes podem ser carregados e exibidos em todas as edições do Windows Vista e XP e em sistemas que tenham apenas o Windows XP Tablet PC Edition Software Development Kit (SDK) 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, verifique o HRESULT retornado contra o erro.

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

Para obter informações sobre quais threads geram eventos específicos, consulte Threads nos quais um evento pode ser acionado.

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

Nota

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 do GroupBox.

Implementação COM

Este objeto implementa o IInkPicture interface COM.

de referência de controle InkEdit

InkOverlay Classe