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 .