InkPicture.Ink Property

Article
10/19/2012

Gets or sets the Ink object that is associated with the InkPicture object.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public Property Ink As Ink
'Usage
Dim instance As InkPicture 
Dim value As Ink 

value = instance.Ink

instance.Ink = value

[BrowsableAttribute(false)]
public Ink Ink { get; set; }

[BrowsableAttribute(false)]
public:
property Ink^ Ink {
    Ink^ get ();
    void set (Ink^ value);
}

public function get Ink () : Ink 
public function set Ink (value : Ink)

Property Value

Type: Microsoft.Ink.Ink
The Ink object that is associated with the InkPicture object.

Remarks

Note

The InkPicture object must be disabled before setting this property. To disable the InkPicture object, set the InkEnabled property to false. You can then set the Ink property, and re-enable the InkPicture object by setting the InkEnabled property to true.

An InkPicture object creates an Ink object by default. If two or more Ink objects exist on a known application window, they can be switched out to enable collection into any one of them (such as after deserializing one of the Ink objects).

Examples

In this example, an InkPicture object works with multiple virtual pages by maintaining multiple Ink objects.

Before pages can be switched, an array of Ink objects is initialized.

mInkArrayPicture = New Ink(MAX_PAGE - 1) {}
For k As Integer = 0 To MAX_PAGE - 1
    mInkArrayPicture(k) = New Ink()
Next

mInkArrayPicture = new Ink[MAX_PAGE];
for (int k = 0; k < MAX_PAGE; k++)
{
    mInkArrayPicture[k] = new Ink();
}

Then, in response to a user action (such as picking from a menu or list), the Ink object of the InkPicture object is reassigned, and the InkPicture object is redrawn.

Private Sub ChangeInkPicturePage(ByVal PageNum As Integer)
    mInkPicture.InkEnabled = False
    mInkPicture.Ink = mInkArrayPicture(PageNum)
    mInkPicture.InkEnabled = True
    mInkPicture.Invalidate()
End Sub

private void ChangeInkPicturePage(int PageNum)
{
    mInkPicture.InkEnabled = false;
    mInkPicture.Ink = mInkArrayPicture[PageNum];
    mInkPicture.InkEnabled = true;
    mInkPicture.Invalidate();
}

Platforms

Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

Share via