InkPicture Class

The InkPicture control provides the ability to place an image in an application and enable users to add ink on top of it. It is intended for scenarios in which ink is not recognized as text but is instead stored as ink.

Definition

Visual Basic .NET	Public Class InkPicture Inherits PictureBox
C#	public class InkPicture : PictureBox
Managed C++	public __gc class InkPicture : public PictureBox

Members Table

The following table lists the members exposed by the object.

Events

Event	Description
AutoSizeChanged	[To be supplied.] Inherited from Control .
BackColorChanged	Occurs when the value of the BackColor property changes. Inherited from Control .
BackgroundImageChanged	Occurs when the value of the BackgroundImage property changes. Inherited from Control .
BackgroundImageLayoutChanged	Occurs when the BackgroundImageLayout property changes. Inherited from Control .
BindingContextChanged	Occurs when the value of the BindingContext property changes. Inherited from Control .
CausesValidationChanged	[To be supplied.] Inherited from PictureBox .
ChangeUICues	Occurs when the focus or keyboard user interface (UI) cues change. Inherited from Control .
Click	Occurs when the control is clicked. Inherited from Control .
ContextMenuChanged	Occurs when the value of the ContextMenu property changes. Inherited from Control .
ControlAdded	Occurs when a new control is added to the ControlCollection . Inherited from Control .
ControlRemoved	Occurs when a control is removed from the ControlCollection . Inherited from Control .
CursorButtonDown	Occurs when the InkPicture detects a cursor button that is down.
CursorButtonUp	Occurs when the InkPicture detects a cursor button that is up.
CursorChanged	Occurs when the value of the Cursor property changes. Inherited from Control .
CursorDown	Occurs when the cursor tip contacts the digitizing tablet surface.
CursorInRange	Occurs when a cursor enters the physical detection range (proximity) of the tablet context.
CursorOutOfRange	Occurs when a cursor leaves the physical detection range (proximity) of the tablet context.
Disposed	Inherited from Component .
DockChanged	Occurs when the value of the Dock property changes. Inherited from Control .
DoubleClick	Occurs when the control is double-clicked. Inherited from Control .
DragDrop	Occurs when a drag-and-drop operation is completed. Inherited from Control .
DragEnter	Occurs when an object is dragged into the control's bounds. Inherited from Control .
DragLeave	Occurs when an object is dragged out of the control's bounds. Inherited from Control .
DragOver	Occurs when an object is dragged over the control's bounds. Inherited from Control .
EnabledChanged	Occurs when the Enabled property value has changed. Inherited from Control .
Enter	Inherited from PictureBox .
FontChanged	[To be supplied.] Inherited from PictureBox .
ForeColorChanged	[To be supplied.] Inherited from PictureBox .
Gesture	Occurs when an application-specific gesture is recognized.
GiveFeedback	Occurs during a drag operation. Inherited from Control .
GotFocus	Occurs when the control receives focus. Inherited from Control .
HandleCreated	Occurs when a handle is created for the control. Inherited from Control .
HandleDestroyed	Occurs when the control's handle is in the process of being destroyed. Inherited from Control .
HelpRequested	Occurs when the user requests help for a control. Inherited from Control .
ImeModeChanged	[To be supplied.] Inherited from PictureBox .
Invalidated	Occurs when a control's display requires redrawing. Inherited from Control .
KeyDown	[To be supplied.] Inherited from PictureBox .
KeyPress	[To be supplied.] Inherited from PictureBox .
KeyUp	[To be supplied.] Inherited from PictureBox .
Layout	Occurs when a control should reposition its child controls. Inherited from Control .
Leave	Inherited from PictureBox .
LoadCompleted	Inherited from PictureBox .
LoadProgressChanged	Inherited from PictureBox .
LocationChanged	Occurs when the Location property value has changed. Inherited from Control .
LostFocus	Occurs when the control loses focus. Inherited from Control .
MouseCaptureChanged	Occurs when the control loses mouse capture. Inherited from Control .
MouseClick	Occurs when the control is clicked by the mouse. Inherited from Control .
MouseDoubleClick	Occurs when the control is double clicked by the mouse. Inherited from Control .
MouseDown	Occurs when the mouse pointer is over the control and a mouse button is pressed. Inherited from Control .
MouseEnter	Occurs when the mouse pointer enters the control. Inherited from Control .
MouseHover	Occurs when the mouse pointer hovers over the control. Inherited from Control .
MouseLeave	Occurs when the mouse pointer leaves the control. Inherited from Control .
MouseMove	Occurs when the mouse pointer is moved over the control. Inherited from Control .
MouseUp	Occurs when the mouse pointer is over the control and a mouse button is released. Inherited from Control .
MouseWheel	Occurs when the mouse wheel moves while the control has focus. Inherited from Control .
Move	Occurs when the control is moved. Inherited from Control .
NewInAirPackets	Occurs when an in-air packet is seen, which happens when a user moves a pen near the tablet and the cursor is within the InkPicture or the user moves a mouse within the InkPicture.
NewPackets	Occurs when the InkPicture receives packets.
Paint	Occurs when the control is redrawn. Inherited from Control .
Painted	Occurs when the InkPicture object has completed redrawing itself.
Painting	Occurs before the InkPicture object redraws itself.
ParentChanged	Occurs when the Parent property value changes. Inherited from Control .
QueryAccessibilityHelp	Occurs when AccessibleObject is providing help to accessibility applications. Inherited from Control .
QueryContinueDrag	Occurs during a drag-and-drop operation and allows the drag source to determine whether the drag-and-drop operation should be canceled. Inherited from Control .
Resize	Occurs when the control is resized. Inherited from Control .
ResizeBegin	Occurs when the user begins to resize a control. Inherited from Control .
ResizeEnd	Occurs when the user stops resizing a control. Inherited from Control .
RightToLeftChanged	[To be supplied.] Inherited from PictureBox .
SelectionChanged	Occurs when the selection of ink within the control has changed, such as through alterations to the user interface, cut-and-paste procedures, or the Selection property.
SelectionChanging	Occurs when the selection of ink within the control is about to change, such as through alterations to the user interface, cut-and-paste procedures, or the Selection property.
SelectionMoved	Occurs when the position of the current selection has changed, such as through alterations to the user interface, cut-and-paste procedures, or the Selection property.
SelectionMoving	Occurs when the position of the current selection is about to change, such as through alterations to the user interface, cut-and-paste procedures, or the Selection property.
SelectionResized	Occurs when the size of the current selection has changed, such as through alterations to the user interface, cut-and-paste procedures, or the Selection property.
SelectionResizing	Occurs when the size of the current selection is about to change, such as through alterations to the user interface, cut-and-paste procedures, or the Selection property.
SizeChanged	Occurs when the Size property value changes. Inherited from Control .
SizeModeChanged	Occurs when SizeMode changes. Inherited from PictureBox .
Stroke	Occurs when the user finishes drawing a new stroke on any tablet.
StrokesDeleted	Occurs after strokes have been deleted from the Ink property.
StrokesDeleting	Occurs before strokes are deleted from the Ink property.
StyleChanged	Occurs when the control style changes. Inherited from Control .
SystemColorsChanged	Occurs when the system colors change. Inherited from Control .
SystemGesture	Occurs when a system gesture is recognized.
TabIndexChanged	[To be supplied.] Inherited from PictureBox .
TabletAdded	Occurs when a Tablet is added to the system.
TabletRemoved	Occurs when a Tablet is removed from the system.
TabStopChanged	[To be supplied.] Inherited from PictureBox .
TextChanged	[To be supplied.] Inherited from PictureBox .
Validated	Occurs when the control is finished validating. Inherited from Control .
Validating	Occurs when the control is validating. Inherited from Control .
VisibleChanged	Occurs when the Visible property value changes. Inherited from Control .

Fields

Field	Description
ClipInkToMargin	Not implemented.
DefaultMargin	Returns the default margin used by the MarginX and MarginY properties.

Methods

Method	Description
AccessibilityNotifyClients	Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. Inherited from Control .
BeginInvoke	Executes a delegate asynchronously on the thread that the control's underlying handle was created on. Inherited from Control .
BringToFront	Brings the control to the front of the z-order. Inherited from Control .
CancelAsync	Inherited from PictureBox .
Contains	Retrieves a value indicating whether the specified control is a child of the control. Inherited from Control .
CreateAccessibilityInstance	Creates a new accessibility object for the control. Inherited from Control .
CreateControl	Forces the creation of the control, including the creation of the handle and any child controls. Inherited from Control .
CreateControlsInstance	Creates a new instance of the control collection for the control. Inherited from Control .
CreateGraphics	Creates the Graphics object for the control. Inherited from Control .
CreateHandle	Creates a handle for the control. Inherited from Control .
DefWndProc	Sends the specified message to the default window procedure. Inherited from Control .
DestroyHandle	Destroys the handle associated with the control. Inherited from Control .
Dispose	Inherited from Component .
Dispose	Releases resources used by the InkPicture object.
DoDragDrop	Begins a drag-and-drop operation. Inherited from Control .
EndInvoke	Retrieves the return value of the asynchronous operation represented by the IAsyncResult object passed. Inherited from Control .
Equals	Determines whether two Object instances are equal. Inherited from Object .
Finalize	Inherited from Component .
FindForm	Retrieves the form that the control is on. Inherited from Control .
Focus	Sets input focus to the control. Inherited from Control .
FromChildHandle	Retrieves the control that contains the specified handle. Inherited from Control .
FromHandle	Returns the control that is currently associated with the specified handle. Inherited from Control .
GetChildAtPoint	Retrieves the child control that is located at the specified coordinates. Inherited from Control .
GetContainerControl	Returns the next ContainerControl up the control's chain of parent controls. Inherited from Control .
GetGestureStatus	Returns a value that indicates whether the InkPicture control has interest in a particular application gesture.
GetHashCode	Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. Inherited from Object .
GetNextControl	Retrieves the next control forward or back in the tab order of child controls. Inherited from Control .
GetPreferredSize	Retrieves the size of a rectangular area into which a control can be fitted. Inherited from Control .
GetService	Inherited from Component .
GetStyle	Retrieves the value of the specified control style bit for the control. Inherited from Control .
GetTopLevel	Determines if the control is a top-level control. Inherited from Control .
GetType	Gets the Type of the current instance. Inherited from Object .
GetWindowInputRectangle	Gets the window rectangle, in pixels, within which ink is drawn.
Hide	Conceals the control from the user. Inherited from Control .
HitTestSelection	Returns a value that indicates which part of a selection, if any, was hit during a hit test.
IEnablable.Disable	Inherited from Control .
IEnablable.Enable	Inherited from Control .
InitLayout	Called after the control has been added to another container. Inherited from Control .
InkPicture	Initializes a new instance of the InkPicture control.
Invalidate	Invalidates a specific region of the control and causes a paint message to be sent to the control. Inherited from Control .
Invoke	Executes a delegate on the thread that owns the control's underlying window handle. Inherited from Control .
InvokeGotFocus	Raises the GotFocus event for the specified control. Inherited from Control .
InvokeLostFocus	Raises the LostFocus event for the specified control. Inherited from Control .
InvokeOnClick	Raises the Click event for the specified control. Inherited from Control .
InvokePaint	Raises the Paint event for the specified control. Inherited from Control .
InvokePaintBackground	Raises the PaintBackground event for the specified control. Inherited from Control .
IsInputChar	Determines if a character is an input character that the control recognizes. Inherited from Control .
IsInputKey	Determines whether the specified key is a regular input key or a special key that requires preprocessing. Inherited from Control .
IsKeyLocked	Determines whether the CAPS LOCK, NUM LOCK, or SCROLL LOCK key is in effect. Inherited from Control .
IsMnemonic	Determines if the specified character is the mnemonic character assigned to the control in the specified string. Inherited from Control .
ISupportInitialize.BeginInit	Inherited from PictureBox .
ISupportInitialize.EndInit	Inherited from PictureBox .
Load	Inherited from PictureBox .
LoadAsync	Inherited from PictureBox .
MemberwiseClone	Creates a shallow copy of the current Object . Inherited from Object .
NotifyInvalidate	Raises the Invalidated event with a specified region of the control to invalidate. Inherited from Control .
OnAutoSizeChanged	[To be supplied.] Inherited from Control .
OnBackColorChanged	Raises the BackColorChanged event. Inherited from Control .
OnBackgroundImageChanged	Raises the BackgroundImageChanged event. Inherited from Control .
OnBackgroundImageLayoutChanged	Raises the BackgroundImageLayoutChanged event. Inherited from Control .
OnBindingContextChanged	Raises the BindingContextChanged event. Inherited from Control .
OnCausesValidationChanged	Raises the CausesValidationChanged event. Inherited from Control .
OnChangeUICues	Raises the ChangeUICues event. Inherited from Control .
OnClick	Raises the Click event. Inherited from Control .
OnContextMenuChanged	Raises the ContextMenuChanged event. Inherited from Control .
OnControlAdded	Raises the ControlAdded event. Inherited from Control .
OnControlRemoved	Raises the ControlRemoved event. Inherited from Control .
OnCreateControl	Raises the CreateControl event. Inherited from Control .
OnCursorButtonDown	Allows derived classes to modify the default behavior of the CursorButtonDown event.
OnCursorButtonUp	Allows derived classes to modify the default behavior of the CursorButtonUp event.
OnCursorChanged	Raises the CursorChanged event. Inherited from Control .
OnCursorDown	Allows derived classes to modify the default behavior of the CursorDown event.
OnCursorInRange	Allows derived classes to modify the default behavior of the CursorInRange event.
OnCursorOutOfRange	Allows derived classes to modify the default behavior of the CursorOutOfRange event.
OnDockChanged	Raises the DockChanged event. Inherited from Control .
OnDoubleClick	Raises the DoubleClick event. Inherited from Control .
OnDragDrop	Raises the DragDrop event. Inherited from Control .
OnDragEnter	Raises the DragEnter event. Inherited from Control .
OnDragLeave	Raises the DragLeave event. Inherited from Control .
OnDragOver	Raises the DragOver event. Inherited from Control .
OnEnabledChanged	[To be supplied.] Inherited from PictureBox .
OnEnter	Raises the Enter event. Inherited from Control .
OnFontChanged	Raises the FontChanged event. Inherited from Control .
OnForeColorChanged	Raises the ForeColorChanged event. Inherited from Control .
OnGesture	Allows derived classes to modify the default behavior of the Gesture event.
OnGiveFeedback	Raises the GiveFeedback event. Inherited from Control .
OnGotFocus	Raises the GotFocus event. Inherited from Control .
OnHandleCreated	Allows derived classes to modify the default behavior of the HandleCreated event.
OnHandleDestroyed	Allows derived classes to modify the default behavior of the HandleDestroyed event.
OnHelpRequested	Raises the HelpRequested event. Inherited from Control .
OnImeModeChanged	Raises the ImeModeChanged event. Inherited from Control .
OnInvalidated	Raises the Invalidated event. Inherited from Control .
OnKeyDown	Allows derived classes to modify the default behavior of the KeyDown event.
OnKeyPress	Raises the KeyPress event. Inherited from Control .
OnKeyUp	Raises the KeyUp event. Inherited from Control .
OnLayout	Raises the Layout event. Inherited from Control .
OnLeave	Raises the Leave event. Inherited from Control .
OnLoadCompleted	Inherited from PictureBox .
OnLoadProgressChanged	Inherited from PictureBox .
OnLocationChanged	Raises the LocationChanged event. Inherited from Control .
OnLostFocus	Raises the LostFocus event. Inherited from Control .
OnMouseCaptureChanged	Raises the MouseCaptureChanged event. Inherited from Control .
OnMouseClick	Raises the MouseClick event. Inherited from Control .
OnMouseDoubleClick	Raises the MouseDoubleClick event. Inherited from Control .
OnMouseDown	Allows derived classes to modify the default behavior of the MouseDown event.
OnMouseEnter	Raises the MouseEnter event. Inherited from Control .
OnMouseHover	Raises the MouseHover event. Inherited from Control .
OnMouseLeave	Raises the MouseLeave event. Inherited from Control .
OnMouseMove	Raises the MouseMove event. Inherited from Control .
OnMouseUp	Raises the MouseUp event. Inherited from Control .
OnMouseWheel	Raises the MouseWheel event. Inherited from Control .
OnMove	Raises the Move event. Inherited from Control .
OnNewInAirPackets	Allows derived classes to modify the default behavior of the NewInAirPackets event.
OnNewPackets	Allows derived classes to modify the default behavior of the NewPackets event.
OnNotifyMessage	Notifies the control of Windows messages. Inherited from Control .
OnPaint	Overridden onPaint to make sure that the image is painted correctly. Inherited from PictureBox .
OnPaintBackground	Paints the background of the control. Inherited from Control .
OnPainted	Allows derived classes to modify the default behavior of the Painted event.
OnPainting	Allows derived classes to modify the default behavior of the Painting event.
OnParentBackColorChanged	Raises the BackColorChanged event when the BackColor property value of the control's container changes. Inherited from Control .
OnParentBackgroundImageChanged	Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes. Inherited from Control .
OnParentBindingContextChanged	Raises the BindingContextChanged event when the BindingContext property value of the control's container changes. Inherited from Control .
OnParentChanged	[To be supplied.] Inherited from PictureBox .
OnParentEnabledChanged	Raises the EnabledChanged event when the Enabled property value of the control's container changes. Inherited from Control .
OnParentFontChanged	Raises the FontChanged event when the Font property value of the control's container changes. Inherited from Control .
OnParentForeColorChanged	Raises the ForeColorChanged event when the ForeColor property value of the control's container changes. Inherited from Control .
OnParentRightToLeftChanged	Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes. Inherited from Control .
OnParentVisibleChanged	Raises the VisibleChanged event when the Visible property value of the control's container changes. Inherited from Control .
OnQueryContinueDrag	Raises the QueryContinueDrag event. Inherited from Control .
OnResize	OnResize override to invalidate entire control in Stetch mode Inherited from PictureBox .
OnResizeBegin	Raises the ResizeBegin event. Inherited from Control .
OnResizeEnd	Raises the ResizeEnd event. Inherited from Control .
OnRightToLeftChanged	Raises the RightToLeftChanged event. Inherited from Control .
OnSelectionChanged	Allows derived classes to modify the default behavior of the SelectionChanged event.
OnSelectionChanging	Allows derived classes to modify the default behavior of the SelectionChanging event.
OnSelectionMoved	Allows derived classes to modify the default behavior of the SelectionMoved event.
OnSelectionMoving	Allows derived classes to modify the default behavior of the SelectionMoving event.
OnSelectionResized	Allows derived classes to modify the default behavior of the SelectionResized event.
OnSelectionResizing	Allows derived classes to modify the default behavior of the SelectionResizing event.
OnSizeChanged	Raises the SizeChanged event. Inherited from Control .
OnSizeModeChanged	Raises the SizeModeChanged event. Inherited from PictureBox .
OnStroke	Allows derived classes to modify the default behavior of the Stroke event.
OnStrokesDeleted	Allows derived classes to modify the default behavior of the StrokesDeleted event.
OnStrokesDeleting	Allows derived classes to modify the default behavior of the StrokesDeleting event.
OnStyleChanged	Raises the StyleChanged event. Inherited from Control .
OnSystemColorsChanged	Raises the SystemColorsChanged event. Inherited from Control .
OnSystemGesture	Allows derived classes to modify the default behavior of the SystemGesture event.
OnTabIndexChanged	Raises the TabIndexChanged event. Inherited from Control .
OnTabletAdded	Allows derived classes to modify the default behavior of the TabletAdded event.
OnTabletRemoved	Allows derived classes to modify the default behavior of the TabletRemoved event.
OnTabStopChanged	Raises the TabStopChanged event. Inherited from Control .
OnTextChanged	Raises the TextChanged event. Inherited from Control .
OnValidated	Raises the Validated event. Inherited from Control .
OnValidating	Raises the Validating event. Inherited from Control .
OnVisibleChanged	[To be supplied.] Inherited from PictureBox .
PerformLayout	Forces the control to apply layout logic to child controls. Inherited from Control .
PointToClient	Computes the location of the specified screen point into client coordinates. Inherited from Control .
PointToScreen	Computes the location of the specified client point into screen coordinates. Inherited from Control .
PreProcessMessage	Preprocesses keyboard or input messages within the message loop before they are dispatched. Inherited from Control .
ProcessCmdKey	Processes a command key. Inherited from Control .
ProcessDialogChar	Processes a dialog character. Inherited from Control .
ProcessDialogKey	Processes a dialog key. Inherited from Control .
ProcessKeyEventArgs	Processes a key message and generates the appropriate control events. Inherited from Control .
ProcessKeyMessage	Processes a keyboard message. Inherited from Control .
ProcessKeyPreview	Previews a keyboard message. Inherited from Control .
ProcessMnemonic	Processes a mnemonic character. Inherited from Control .
RaiseDragEvent	Raises the appropriate drag event. Inherited from Control .
RaiseKeyEvent	Raises the appropriate key event. Inherited from Control .
RaiseMouseEvent	Raises the appropriate mouse event. Inherited from Control .
RaisePaintEvent	Raises the appropriate paint event. Inherited from Control .
RecreateHandle	Forces the re-creation of the handle for the control. Inherited from Control .
RectangleToClient	Computes the size and location of the specified screen rectangle in client coordinates. Inherited from Control .
RectangleToScreen	Computes the size and location of the specified client rectangle in screen coordinates. Inherited from Control .
ReferenceEquals	Determines whether the specified Object instances are the same instance. Inherited from Object .
ReflectMessage	Reflects the specified message to the control that is bound to the specified handle. Inherited from Control .
Refresh	Forces the control to invalidate its client area and immediately redraw itself and any child controls. Inherited from Control .
ResetBackColor	Resets the BackColor property to its default value. Inherited from Control .
ResetBindings	Resets the DataBindings property to its default value. Inherited from Control .
ResetCursor	Resets the Cursor property to its default value. Inherited from Control .
ResetFont	Resets the Font property to its default value. Inherited from Control .
ResetForeColor	Resets the ForeColor property to its default value. Inherited from Control .
ResetImeMode	Resets the ImeMode property to its default value. Inherited from Control .
ResetMouseEventArgs	Resets the mouse leave listeners. Inherited from Control .
ResetRightToLeft	Resets the RightToLeft property to its default value. Inherited from Control .
ResetText	Resets the Text property to its default value. Inherited from Control .
ResumeLayout	Resumes normal layout logic. Inherited from Control .
RtlTranslateAlignment	Converts the current alignment to the appropriate alignment to support right-to-left text. Inherited from Control .
RtlTranslateContent	Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. Inherited from Control .
RtlTranslateHorizontal	Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. Inherited from Control .
RtlTranslateLeftRight	Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. Inherited from Control .
Scale	Scales the control and any child controls. Inherited from Control .
ScaleCore	Performs the work of scaling the entire control and any child controls. Inherited from Control .
ScrollWindow	Scrolls the contents of the specified window's client area. Inherited from Control .
Select	Activates a control. Inherited from Control .
SelectNextControl	Activates the next control. Inherited from Control .
SendToBack	Sends the control to the back of the z-order. Inherited from Control .
SetAllTabletsMode	Sets the InkPicture control to collect ink from any tablet attached to the Tablet PC.
SetBounds	Sets the bounds of the control. Inherited from Control .
SetBoundsCore	Overrides Control.setBoundsCore to enforce autoSize. Inherited from PictureBox .
SetClientSizeCore	Sets the size of the client area of the control. Inherited from Control .
SetGestureStatus	Sets whether or not the InkPicture object has interest in a known application gesture.
SetSingleTabletIntegratedMode	Sets the InkPicture control to collect ink from only one tablet attached to the Tablet PC. Ink from other tablets is ignored by the InkPicture control.
SetStyle	Sets the specified style bit to the specified value. Inherited from Control .
SetTopLevel	Sets the control as the top-level control. Inherited from Control .
SetVisibleCore	Sets the control to the specified visible state. Inherited from Control .
SetWindowInputRectangle	Sets the window rectangle, in pixels, within which ink is drawn.
Show	Displays the control to the user. Inherited from Control .
SuspendLayout	Temporarily suspends the layout logic for the control. Inherited from Control .
ToString	Returns a string representation for this control. Inherited from PictureBox .
Update	Causes the control to redraw the invalidated regions within its client area. Inherited from Control .
UpdateBounds	Updates the bounds of the control. Inherited from Control .
UpdateStyles	Forces the assigned styles to be reapplied to the control. Inherited from Control .
UpdateZOrder	Updates the control in its parent's z-order. Inherited from Control .
WndProc	Processes Windows messages. Inherited from Control .

Properties

Property	Description
AccessibilityObject	Gets the AccessibleObject assigned to the control. Inherited from Control .
AccessibleDefaultActionDescription	Gets or sets the default action description of the control for use by accessibility client applications. Inherited from Control .
AccessibleDescription	Gets or sets the description of the control used by accessibility client applications. Inherited from Control .
AccessibleName	Gets or sets the name of the control used by accessibility client applications. Inherited from Control .
AccessibleRole	Gets or sets the accessible role of the control Inherited from Control .
AllowDrop	Inherited from PictureBox .
Anchor	Gets or sets which edges of the control are anchored to the edges of its container. Inherited from Control .
AutoRedraw	Gets or sets a value that specifies whether the InkPicture control repaints the ink when the window is invalidated.
AutoSize	[To be supplied.] Inherited from Control .
BackColor	Gets or sets the background color for the control. Inherited from Control .
BackgroundImage	Gets or sets the background image displayed in the control. Inherited from Control .
BackgroundImageLayout	Gets or sets the background image layout as defined in the ImageLayout enumeration. Inherited from Control .
BindingContext	Gets or sets the BindingContext for the control. Inherited from Control .
BorderStyle	Indicates the border style for the control. Inherited from PictureBox .
Bottom	Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area. Inherited from Control .
Bounds	Gets or sets the size and location of the control including its nonclient elements. Inherited from Control .
CanFocus	Gets a value indicating whether the control can receive focus. Inherited from Control .
CanRaiseEvents	Determines if events can be fired on the control. Inherited from Control .
CanSelect	Gets a value indicating whether the control can be selected. Inherited from Control .
Capture	Gets or sets a value indicating whether the control has captured the mouse. Inherited from Control .
CausesValidation	[To be supplied.] Inherited from PictureBox .
CheckForIllegalCrossThreadCalls	Gets or sets a value indicating whether to catch calls on the wrong thread that access a control's Handle property. Inherited from Control .
ClientRectangle	Gets the rectangle that represents the client area of the control. Inherited from Control .
ClientSize	Gets or sets the height and width of the client area of the control. Inherited from Control .
CollectingInk	Gets a value that specifies whether ink is currently being drawn on an InkPicture control.
CollectionMode	Gets or sets the collection mode that determines whether ink, gestures, or both are recognized as the user writes.
CompanyName	Gets the name of the company or creator of the application containing the control. Inherited from Control .
Container	Inherited from Component .
ContainsFocus	Gets a value indicating whether the control, or one of its child controls, currently has the input focus. Inherited from Control .
ContextMenu	Gets or sets the shortcut menu associated with the control. Inherited from Control .
Controls	Gets the collection of controls contained within the control. Inherited from Control .
Created	Gets a value indicating whether the control has been created. Inherited from Control .
CreateParams	Returns the parameters needed to create the handle. Inheriting classes can override this to provide extra functionality. They should not, however, forget to call base.getCreateParams() first to get the struct filled up with the basic info. Inherited from PictureBox .
Cursor	Gets or sets the cursor that appears when the mouse pointer is over the InkPicture control.
Cursors	Gets the Cursors collection that is available for use in the inking region.
DataBindings	Gets the data bindings for the control. Inherited from Control .
DefaultBackColor	Gets the default background color of the control. Inherited from Control .
DefaultCursor	Gets or sets the default cursor for the control. Inherited from Control .
DefaultDrawingAttributes	Gets or sets the default DrawingAttributes object, which specifies the drawing attributes that are used when drawing and displaying ink.
DefaultFont	Gets the default font of the control. Inherited from Control .
DefaultForeColor	Gets the default foreground color of the control. Inherited from Control .
DefaultImeMode	Gets a value indicating the mode for Input Method Editor (IME) for the PictureBox . Inherited from PictureBox .
DefaultSize	[To be supplied.] Inherited from PictureBox .
DesignMode	Inherited from Component .
DesiredPacketDescription	Gets or sets interest in aspects of the packets associated with ink drawn on the InkPicture object.
DisplayRectangle	Gets the rectangle that represents the display area of the control. Inherited from Control .
Disposing	Gets a value that indicates whether the InkPicture control is being disposed of.
Dock	Gets or sets which edge of the parent container a control is docked to. Inherited from Control .
DoubleBuffered	Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. Inherited from Control .
DynamicRendering	Gets or sets a value that indicates whether ink is rendered as it is drawn.
EditingMode	Gets or sets a value that indicates whether the InkPicture is in ink mode, delete mode, or select/edit mode.
Enabled	Gets or sets a value indicating whether the control can respond to user interaction. Inherited from Control .
EraserMode	Gets or sets a value that indicates whether ink is erased by stroke or by point.
EraserWidth	Gets or sets a value that specifies the width of the eraser pen tip.
ErrorImage	Inherited from PictureBox .
Events	Inherited from Component .
Focused	Gets a value indicating whether the control has input focus. Inherited from Control .
Font	Inherited from PictureBox .
FontHeight	Gets or sets the height of the font of the control. Inherited from Control .
ForeColor	Inherited from PictureBox .
Handle	Gets the window handle that the control is bound to. Inherited from Control .
HasChildren	Gets a value indicating whether the control contains one or more child controls. Inherited from Control .
Height	Gets or sets the height of the control. Inherited from Control .
Image	Gets or sets the image that the PictureBox displays. Inherited from PictureBox .
ImageLocation	Inherited from PictureBox .
ImeMode	Gets or sets the Input Method Editor(IME) mode supported by this control. Inherited from PictureBox .
InitialImage	Inherited from PictureBox .
Ink	Gets or sets the Ink object that is associated with the InkPicture object.
InkEnabled	Gets or sets a value that specifies whether the InkPicture control collects pen input.
InvokeRequired	Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on. Inherited from Control .
IsAccessible	Gets or sets a value indicating whether the control is visible to accessibility applications. Inherited from Control .
IsDisposed	Gets a value indicating whether the control has been disposed of. Inherited from Control .
IsHandleCreated	Gets a value indicating whether the control has a handle associated with it. Inherited from Control .
LayoutEngine	Gets a cached instance of the control's layout engine. Inherited from Control .
Left	Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area. Inherited from Control .
LoadProgress	Inherited from PictureBox .
Location	Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. Inherited from Control .
Margin	Gets or sets the space between controls. Inherited from Control .
MarginX	Gets or sets the margins along the x-axis, in pixels.
MarginY	Gets or sets the margins along the y-axis, in pixels.
MaximumSize	[To be supplied.] Inherited from Control .
MinimumSize	Gets the size that is the lower limit that GetPreferredSize can specify. Inherited from Control .
ModifierKeys	Gets a value indicating which of the modifier keys (SHIFT, CTRL, and ALT) is in a pressed state. Inherited from Control .
MouseButtons	Gets a value indicating which of the mouse buttons is in a pressed state. Inherited from Control .
MousePosition	Gets the position of the mouse cursor in screen coordinates. Inherited from Control .
Name	Gets or sets the name of the control. Inherited from Control .
Padding	Gets or sets padding within the control. Inherited from Control .
Parent	Gets or sets the parent container of the control. Inherited from Control .
Pinned	Gets or sets a value indicating whether the control can be automatically resized and will move other controls during layout. Inherited from Control .
PreferredSize	[To be supplied.] Inherited from Control .
ProductName	Gets the product name of the assembly containing the control. Inherited from Control .
ProductVersion	Gets the version of the assembly containing the control. Inherited from Control .
RecreatingHandle	Gets a value indicating whether the control is currently re-creating its handle. Inherited from Control .
Region	Gets or sets the window region associated with the control. Inherited from Control .
Renderer	Gets or sets the Renderer object that is used to draw ink.
RenderRightToLeft	Inherited from Control .
ResizeRedraw	Gets or sets a value indicating whether the control redraws itself when resized. Inherited from Control .
Right	Gets the distance, in pixels, between the right edge of the control and the left edge of its container's client area. Inherited from Control .
RightToLeft	Inherited from PictureBox .
Selection	Gets or sets the Strokes collection that is currently selected inside the InkPicture control.
ShowFocusCues	Gets a value indicating whether the control should display focus rectangles. Inherited from Control .
ShowKeyboardCues	Gets a value indicating whether the control should display keyboard shortcuts. Inherited from Control .
Site	Gets or sets the site of the control. Inherited from Control .
Size	Gets or sets the height and width of the control. Inherited from Control .
SizeMode	Indicates how the image is displayed. Inherited from PictureBox .
SupportHighContrastInk	Gets or sets a value that specifies whether ink is rendered as just one color when the system is in High Contrast mode.
SupportHighContrastSelectionUI	Gets or sets a value that specifies whether all selection user interface (UI) are drawn in high contrast when the system is in High Contrast mode.
TabIndex	[To be supplied.] Inherited from PictureBox .
Tablet	Gets the tablet device that the InkPicture control is currently using to collect input.
TabStop	Gets or sets a value indicating whether the user can give the focus to this control by pressing the TAB key.
Tag	Gets or sets the object that contains data about the control. Inherited from Control .
Text	Inherited from PictureBox .
Top	Gets or sets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area. Inherited from Control .
TopLevelControl	Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in. Inherited from Control .
UseWaitCursor	Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. Inherited from Control .
Visible	Gets or sets a value indicating whether the control is displayed. Inherited from Control .
WaitOnLoad	Inherited from PictureBox .
Width	Gets or sets the width of the control. Inherited from Control .
WindowTarget	The target of Win32 window messages. Inherited from Control .

Inheritance Hierarchy

Object

MarshalByRefObject

Component

Control

PictureBox

InkPicture

Remarks

Caution: You must call the Dispose method on this object before it goes out of scope. This object maintains non-managed resources. Relying on finalization for this object can cause memory leaks and exceptions within your application.

For an example of disposing managed objects, see Using the Managed Library.

Note: The InkPicture control is not marked safe for scripting. The InkPicture control should not be used in HTML or ASP.NET pages.

The run time user interface for this control is a window with an opaque background (single color, picture background, or both) that contains opaque ink.

You can use the InkPicture control to render ink in Microsoft® Windows® 2000, Windows Server 2003, and any edition of Windows XP other than Tablet PC Edition. However, you can input ink, accept gestures, or recognize handwriting only under the following conditions:

• Ink can be input and recognized only if Windows XP Tablet PC Edition is installed.
• Gestures can be recognized only if Windows XP Tablet PC Edition is installed.
• Handwriting can be recognized as text if the handwriting originated elsewhere and if recognizers are present.

If you use Windows 2000, Windows Server 2003, or any edition of Windows XP other than Tablet PC Edition, you can assign values to the ambient properties of the InkPicture control and copy and paste ink to other applications, but the value of its InkEnabled property is always false.

Persisted Ink objects can be loaded and displayed on all editions of Windows XP (including the Tablet PC Edition). However, the Ink objects can be converted to text (recognized) only if Windows XP Tablet PC Edition is installed.

For more information about ink controls, see Ink Controls.

For information about which threads raise particular events, see Threads on Which an Event Can Fire.

To improve your application's performance, manually dispose of an InkPicture control when it is no longer needed.

Security Alert: If using under partial trust, this class and all its methods require UIPermissionWindow.SafeTopLevelWindows permission. See Security And Trust for more information.

Class Information

Namespace	Microsoft.Ink
Assembly	Microsoft.Ink (microsoft.ink.dll)
Strong Name	Microsoft.Ink, Version=1.7.4009.0, Culture=neutral, PublicKeyToken=a2870d9cc4d021c8

See Also

• InkOverlay Class
• Ink Controls
• Threads on Which an Event Can Fire