Amostra de coleção de tinta

Este aplicativo é baseado no objeto InkCollector e demonstra a coleção de tinta. O aplicativo cria uma janela, anexa um objeto InkCollector a ela e fornece ao usuário opções de menu que podem ser usadas para alterar a cor da tinta, a largura da tinta e habilitar e desabilitar a coleção de tinta.

Observação

A versão discutida nesta seção é Visual Basic .NET. Os conceitos são os mesmos entre outras versões linguísticas na biblioteca de exemplos.

 

Declarando o Colecionador de Tinta

O aplicativo primeiro importa o namespace Microsoft.Ink. Em seguida, a aplicação declara myInkCollector, que contém o objeto InkCollector para o formulário.

' The Ink namespace, which contains the Tablet PC Platform APIImports Microsoft.Ink
...
Public Class InkCollection
   Inherits Form
    ' Declare the Ink Collector object
    Private myInkCollector

Configurando as coisas

O método InkCollection_Load do formulário manipula o evento Load do formulário. Ele cria um objeto InkCollector atribuído ao formulário, modifica a propriedade DefaultDrawingAttributes do objeto InkCollector e habilita o objeto InkCollector.

Private Sub InkCollection_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

    ' Create an ink collector and assign it to this form's window
    myInkCollector = New InkCollector(Me.Handle)

    ' Set the pen width to be a medium width
    myInkCollector.DefaultDrawingAttributes.Width = MediumInkWidth

    ' If you do not modify the default drawing attributes, the default 
    ' drawing attributes will use the following properties and values:
    ' ...

    ' Turn the ink collector on
    myInkCollector.Enabled = True
End Sub

O InkCollector é atribuído à janela do formulário ao atribuir o identificador de janela do formulário à propriedade Handle do objeto InkCollector . A coleção de tinta é ativada definindo a propriedade Enabled do objeto InkCollector como TRUE.

A propriedade DefaultDrawingAttributes do InkCollector do objeto define os atributos padrão atribuídos a um novo cursor. Para definir atributos diferentes num novo cursor, use a propriedade DrawingAttributes do objeto Cursor. Para alterar os atributos de desenho de um único traçado, use a propriedade DrawingAttributes do objeto Stroke.

Alterando as propriedades

O resto desta aplicação simples consiste em manipuladores para as várias seleções de menu que o usuário pode fazer. Por exemplo, quando o utilizador escolhe alterar a cor da tinta para vermelho selecionando Vermelho no menu Tinta, a cor é alterada usando a propriedade Color do objeto InkCollector na propriedade DefaultDrawingAttributes no manipulador de eventos do menu.

Private Sub miRed_Click(ByVal sender As System.Object, 
                        ByVal e As System.EventArgs) Handles miRed.Click
    myInkCollector.DefaultDrawingAttributes.Color = Color.Red
End Sub

Fechando o formulário

O método Dispose do formulário elimina o objeto InkCollector, myInkCollector.