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++.
Nota
O controle InkPicture não está marcado como seguro para scripts. O controle InkPicture não deve ser usado em HTML ou páginas ASP.NET.
A criação do controle InkPicture por trás de um controle transparente (como um GroupBox com o conjunto de propriedades WS_EX_TRANSPARENT) impedirá o 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. |
| Acontecimento | Descrição |
|---|---|
| ChangeUICues | Deprecado. |
| clique em | Ocorre quando um usuário clica no controle InkPicture. |
| de evento CursorButtonDown | Ocorre quando o controle InkCollector detecta um objetoIInkCursorButtonque está inoperante. |
| de evento CursorButtonUp | Ocorre quando o controle InkPicture detecta uma IInkCursorButton que está ativada. |
| de evento CursorDown | Ocorre quando a ponta do cursor entra em contato com a superfície do tablet de digitalização. |
| de evento CursorInRange | Ocorre quando um cursor entra no intervalo de detecção física (proximidade) do contexto do tablet. |
| de evento CursorOutOfRange | Ocorre quando o cursor deixa o 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. |
| de evento de gesto | Ocorre quando um gesto de aplicativo é reconhecido. |
| evento keydown [controle InkPicture] | Ocorre quando uma tecla é pressionada e na posição para baixo, 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. |
| do MouseEnter | Ocorre quando o ponteiro do mouse entra no controle InkPicture. |
| do 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. |
| do MouseWheel | Ocorre quando a roda do mouse se move enquanto o controle InkPicture tem foco. |
| de eventoNewInAirPackets | Ocorre quando um pacote no ar é visto. |
| de eventos newpackets | Ocorre quando o controle InkPicture recebe um pacote. |
| Pintado | Ocorre quando o controle InkPicture foi concluído redesenhar a si mesmo. |
| de 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 propriedadeseleção de. |
| 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 propriedadeseleção de. |
| SelectionMoved | Ocorre quando a posição da seleção atual é 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 é 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, após as alterações no valor da propriedadede Largura doou Height. |
| SizeModeChanged | Ocorre depois que a propriedadeSizeMode do controle InkPicture foi alterada. |
| StyleChanged | Não implementado. |
| de Traço | 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 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. |
| de eventoadicionado ao tablet | Ocorre quando um tablet é adicionado ao sistema. |
| de eventoTabletRemoved | 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. |
| do 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 da janela a ser definido, nas coordenadas da janela, nas quais a tinta é desenhada. |
| ShowWhatsThisis | Exibe um tópico selecionado em um arquivo de Ajuda usando o pop-up "What's This" 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 é reexaminado 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 Cursores | Obtém a coleçãoIInkCursors disponível para uso na região de escrita à tinta do controle InkPicture. |
| CustomStrokes | Obtém a coleção IInkCustomStrokes a ser mantida com a tinta (somente 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 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. |
| habilitado | Obtém ou define um valor que determina se o controle InkPicture pode responder a eventos gerados pelo usuário. Observação: Essa propriedade é equivalente à propriedadeInkEnabled. |
| 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) |
| Ink | 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 em torno do retângulo da janela nas coordenadas da tela. |
| propriedade MouseIcon | Obtém ou define o ícone do 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. |
| de Imagem | Obtém o arquivo gráfico a ser exibido no controle InkPicture. |
| propriedade Renderizador | Obtém ou define o objetoInkRenderer usado para desenhar tinta no controle InkPicture (somente tempo de execução). |
| de Seleção de | Obtém a coleção 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, 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. |
Observações
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 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 nas 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 tiver se originado 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 ambientes do controle InkPicture e copiar e colar tinta a outros aplicativos. No entanto, o valor de sua propriedade InkEnabled sempre será false.
Os 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) do Windows XP Tablet PC Edition instalado. inkDisp objetos só poderão 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 em relação ao 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 disparar.
Para melhorar o desempenho do 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 de COM
Esse objeto implementa a interface COM IInkPicture.