Classes


Microsoft Tablet PC - Microsoft.Ink.InkPicture
InkPicture Class

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 .NETPublic 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

EventDescription
AutoSizeChanged Leave Site[To be supplied.] Inherited from Control Leave Site.
BackColorChanged Leave SiteOccurs when the value of the BackColor Leave Site property changes. Inherited from Control Leave Site.
BackgroundImageChanged Leave SiteOccurs when the value of the BackgroundImage Leave Site property changes. Inherited from Control Leave Site.
BackgroundImageLayoutChanged Leave SiteOccurs when the BackgroundImageLayout Leave Site property changes. Inherited from Control Leave Site.
BindingContextChanged Leave SiteOccurs when the value of the BindingContext Leave Site property changes. Inherited from Control Leave Site.
CausesValidationChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
ChangeUICues Leave SiteOccurs when the focus or keyboard user interface (UI) cues change. Inherited from Control Leave Site.
Click Leave SiteOccurs when the control is clicked. Inherited from Control Leave Site.
ContextMenuChanged Leave SiteOccurs when the value of the ContextMenu Leave Site property changes. Inherited from Control Leave Site.
ControlAdded Leave SiteOccurs when a new control is added to the ControlCollection Leave Site. Inherited from Control Leave Site.
ControlRemoved Leave SiteOccurs when a control is removed from the ControlCollection Leave Site. Inherited from Control Leave Site.
CursorButtonDownOccurs when the InkPicture detects a cursor button that is down.
CursorButtonUpOccurs when the InkPicture detects a cursor button that is up.
CursorChanged Leave SiteOccurs when the value of the Cursor Leave Site property changes. Inherited from Control Leave Site.
CursorDownOccurs when the cursor tip contacts the digitizing tablet surface.
CursorInRangeOccurs when a cursor enters the physical detection range (proximity) of the tablet context.
CursorOutOfRangeOccurs when a cursor leaves the physical detection range (proximity) of the tablet context.
Disposed Leave Site Inherited from Component Leave Site.
DockChanged Leave SiteOccurs when the value of the Dock Leave Site property changes. Inherited from Control Leave Site.
DoubleClick Leave SiteOccurs when the control is double-clicked. Inherited from Control Leave Site.
DragDrop Leave SiteOccurs when a drag-and-drop operation is completed. Inherited from Control Leave Site.
DragEnter Leave SiteOccurs when an object is dragged into the control's bounds. Inherited from Control Leave Site.
DragLeave Leave SiteOccurs when an object is dragged out of the control's bounds. Inherited from Control Leave Site.
DragOver Leave SiteOccurs when an object is dragged over the control's bounds. Inherited from Control Leave Site.
EnabledChanged Leave SiteOccurs when the Enabled Leave Site property value has changed. Inherited from Control Leave Site.
Enter Leave Site Inherited from PictureBox Leave Site.
FontChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
ForeColorChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
GestureOccurs when an application-specific gesture is recognized.
GiveFeedback Leave SiteOccurs during a drag operation. Inherited from Control Leave Site.
GotFocus Leave SiteOccurs when the control receives focus. Inherited from Control Leave Site.
HandleCreated Leave SiteOccurs when a handle is created for the control. Inherited from Control Leave Site.
HandleDestroyed Leave SiteOccurs when the control's handle is in the process of being destroyed. Inherited from Control Leave Site.
HelpRequested Leave SiteOccurs when the user requests help for a control. Inherited from Control Leave Site.
ImeModeChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
Invalidated Leave SiteOccurs when a control's display requires redrawing. Inherited from Control Leave Site.
KeyDown Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
KeyPress Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
KeyUp Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
Layout Leave SiteOccurs when a control should reposition its child controls. Inherited from Control Leave Site.
Leave Leave Site Inherited from PictureBox Leave Site.
LoadCompleted Leave Site Inherited from PictureBox Leave Site.
LoadProgressChanged Leave Site Inherited from PictureBox Leave Site.
LocationChanged Leave SiteOccurs when the Location Leave Site property value has changed. Inherited from Control Leave Site.
LostFocus Leave SiteOccurs when the control loses focus. Inherited from Control Leave Site.
MouseCaptureChanged Leave SiteOccurs when the control loses mouse capture. Inherited from Control Leave Site.
MouseClick Leave SiteOccurs when the control is clicked by the mouse. Inherited from Control Leave Site.
MouseDoubleClick Leave SiteOccurs when the control is double clicked by the mouse. Inherited from Control Leave Site.
MouseDown Leave SiteOccurs when the mouse pointer is over the control and a mouse button is pressed. Inherited from Control Leave Site.
MouseEnter Leave SiteOccurs when the mouse pointer enters the control. Inherited from Control Leave Site.
MouseHover Leave SiteOccurs when the mouse pointer hovers over the control. Inherited from Control Leave Site.
MouseLeave Leave SiteOccurs when the mouse pointer leaves the control. Inherited from Control Leave Site.
MouseMove Leave SiteOccurs when the mouse pointer is moved over the control. Inherited from Control Leave Site.
MouseUp Leave SiteOccurs when the mouse pointer is over the control and a mouse button is released. Inherited from Control Leave Site.
MouseWheel Leave SiteOccurs when the mouse wheel moves while the control has focus. Inherited from Control Leave Site.
Move Leave SiteOccurs when the control is moved. Inherited from Control Leave Site.
NewInAirPacketsOccurs 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.
NewPacketsOccurs when the InkPicture receives packets.
Paint Leave SiteOccurs when the control is redrawn. Inherited from Control Leave Site.
PaintedOccurs when the InkPicture object has completed redrawing itself.
PaintingOccurs before the InkPicture object redraws itself.
ParentChanged Leave SiteOccurs when the Parent Leave Site property value changes. Inherited from Control Leave Site.
QueryAccessibilityHelp Leave SiteOccurs when AccessibleObject Leave Site is providing help to accessibility applications. Inherited from Control Leave Site.
QueryContinueDrag Leave SiteOccurs 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 Leave Site.
Resize Leave SiteOccurs when the control is resized. Inherited from Control Leave Site.
ResizeBegin Leave SiteOccurs when the user begins to resize a control. Inherited from Control Leave Site.
ResizeEnd Leave SiteOccurs when the user stops resizing a control. Inherited from Control Leave Site.
RightToLeftChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
SelectionChangedOccurs 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.
SelectionChangingOccurs 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.
SelectionMovedOccurs 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.
SelectionMovingOccurs 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.
SelectionResizedOccurs 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.
SelectionResizingOccurs 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 Leave SiteOccurs when the Size Leave Site property value changes. Inherited from Control Leave Site.
SizeModeChanged Leave SiteOccurs when SizeMode Leave Site changes. Inherited from PictureBox Leave Site.
StrokeOccurs when the user finishes drawing a new stroke on any tablet.
StrokesDeletedOccurs after strokes have been deleted from the Ink property.
StrokesDeletingOccurs before strokes are deleted from the Ink property.
StyleChanged Leave SiteOccurs when the control style changes. Inherited from Control Leave Site.
SystemColorsChanged Leave SiteOccurs when the system colors change. Inherited from Control Leave Site.
SystemGestureOccurs when a system gesture is recognized.
TabIndexChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
TabletAddedOccurs when a Tablet is added to the system.
TabletRemovedOccurs when a Tablet is removed from the system.
TabStopChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
TextChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
Validated Leave SiteOccurs when the control is finished validating. Inherited from Control Leave Site.
Validating Leave SiteOccurs when the control is validating. Inherited from Control Leave Site.
VisibleChanged Leave SiteOccurs when the Visible Leave Site property value changes. Inherited from Control Leave Site.

Fields

FieldDescription
ClipInkToMarginNot implemented.
DefaultMarginReturns the default margin used by the MarginX and MarginY properties.

Methods

MethodDescription
AccessibilityNotifyClients Leave SiteNotifies the accessibility client applications of the specified AccessibleEvents Leave Site for the specified child control. Inherited from Control Leave Site.
BeginInvoke Leave SiteExecutes a delegate asynchronously on the thread that the control's underlying handle was created on. Inherited from Control Leave Site.
BringToFront Leave SiteBrings the control to the front of the z-order. Inherited from Control Leave Site.
CancelAsync Leave Site Inherited from PictureBox Leave Site.
Contains Leave SiteRetrieves a value indicating whether the specified control is a child of the control. Inherited from Control Leave Site.
CreateAccessibilityInstance Leave SiteCreates a new accessibility object for the control. Inherited from Control Leave Site.
CreateControl Leave SiteForces the creation of the control, including the creation of the handle and any child controls. Inherited from Control Leave Site.
CreateControlsInstance Leave SiteCreates a new instance of the control collection for the control. Inherited from Control Leave Site.
CreateGraphics Leave SiteCreates the Graphics Leave Site object for the control. Inherited from Control Leave Site.
CreateHandle Leave SiteCreates a handle for the control. Inherited from Control Leave Site.
DefWndProc Leave SiteSends the specified message to the default window procedure. Inherited from Control Leave Site.
DestroyHandle Leave SiteDestroys the handle associated with the control. Inherited from Control Leave Site.
Dispose Leave Site Inherited from Component Leave Site.
DisposeReleases resources used by the InkPicture object.
DoDragDrop Leave SiteBegins a drag-and-drop operation. Inherited from Control Leave Site.
EndInvoke Leave SiteRetrieves the return value of the asynchronous operation represented by the IAsyncResult Leave Site object passed. Inherited from Control Leave Site.
Equals Leave SiteDetermines whether two Object Leave Site instances are equal. Inherited from Object Leave Site.
Finalize Leave Site Inherited from Component Leave Site.
FindForm Leave SiteRetrieves the form that the control is on. Inherited from Control Leave Site.
Focus Leave SiteSets input focus to the control. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)FromChildHandle Leave SiteRetrieves the control that contains the specified handle. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)FromHandle Leave SiteReturns the control that is currently associated with the specified handle. Inherited from Control Leave Site.
GetChildAtPoint Leave SiteRetrieves the child control that is located at the specified coordinates. Inherited from Control Leave Site.
GetContainerControl Leave SiteReturns the next ContainerControl Leave Site up the control's chain of parent controls. Inherited from Control Leave Site.
GetGestureStatusReturns a value that indicates whether the InkPicture control has interest in a particular application gesture.
GetHashCode Leave SiteServes as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. Inherited from Object Leave Site.
GetNextControl Leave SiteRetrieves the next control forward or back in the tab order of child controls. Inherited from Control Leave Site.
GetPreferredSize Leave SiteRetrieves the size of a rectangular area into which a control can be fitted. Inherited from Control Leave Site.
GetService Leave Site Inherited from Component Leave Site.
GetStyle Leave SiteRetrieves the value of the specified control style bit for the control. Inherited from Control Leave Site.
GetTopLevel Leave SiteDetermines if the control is a top-level control. Inherited from Control Leave Site.
GetType Leave SiteGets the Type Leave Site of the current instance. Inherited from Object Leave Site.
GetWindowInputRectangleGets the window rectangle, in pixels, within which ink is drawn.
Hide Leave SiteConceals the control from the user. Inherited from Control Leave Site.
HitTestSelectionReturns a value that indicates which part of a selection, if any, was hit during a hit test.
IEnablable.Disable Leave Site Inherited from Control Leave Site.
IEnablable.Enable Leave Site Inherited from Control Leave Site.
InitLayout Leave SiteCalled after the control has been added to another container. Inherited from Control Leave Site.
InkPictureInitializes a new instance of the InkPicture control.
Invalidate Leave SiteInvalidates a specific region of the control and causes a paint message to be sent to the control. Inherited from Control Leave Site.
Invoke Leave SiteExecutes a delegate on the thread that owns the control's underlying window handle. Inherited from Control Leave Site.
InvokeGotFocus Leave SiteRaises the GotFocus Leave Site event for the specified control. Inherited from Control Leave Site.
InvokeLostFocus Leave SiteRaises the LostFocus Leave Site event for the specified control. Inherited from Control Leave Site.
InvokeOnClick Leave SiteRaises the Click Leave Site event for the specified control. Inherited from Control Leave Site.
InvokePaint Leave SiteRaises the Paint Leave Site event for the specified control. Inherited from Control Leave Site.
InvokePaintBackground Leave SiteRaises the PaintBackground event for the specified control. Inherited from Control Leave Site.
IsInputChar Leave SiteDetermines if a character is an input character that the control recognizes. Inherited from Control Leave Site.
IsInputKey Leave SiteDetermines whether the specified key is a regular input key or a special key that requires preprocessing. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)IsKeyLocked Leave SiteDetermines whether the CAPS LOCK, NUM LOCK, or SCROLL LOCK key is in effect. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)IsMnemonic Leave SiteDetermines if the specified character is the mnemonic character assigned to the control in the specified string. Inherited from Control Leave Site.
ISupportInitialize.BeginInit Leave Site Inherited from PictureBox Leave Site.
ISupportInitialize.EndInit Leave Site Inherited from PictureBox Leave Site.
Load Leave Site Inherited from PictureBox Leave Site.
LoadAsync Leave Site Inherited from PictureBox Leave Site.
MemberwiseClone Leave SiteCreates a shallow copy of the current Object Leave Site. Inherited from Object Leave Site.
NotifyInvalidate Leave SiteRaises the Invalidated Leave Site event with a specified region of the control to invalidate. Inherited from Control Leave Site.
OnAutoSizeChanged Leave Site[To be supplied.] Inherited from Control Leave Site.
OnBackColorChanged Leave SiteRaises the BackColorChanged Leave Site event. Inherited from Control Leave Site.
OnBackgroundImageChanged Leave SiteRaises the BackgroundImageChanged Leave Site event. Inherited from Control Leave Site.
OnBackgroundImageLayoutChanged Leave SiteRaises the BackgroundImageLayoutChanged Leave Site event. Inherited from Control Leave Site.
OnBindingContextChanged Leave SiteRaises the BindingContextChanged Leave Siteevent. Inherited from Control Leave Site.
OnCausesValidationChanged Leave SiteRaises the CausesValidationChanged Leave Siteevent. Inherited from Control Leave Site.
OnChangeUICues Leave SiteRaises the ChangeUICues Leave Site event. Inherited from Control Leave Site.
OnClick Leave SiteRaises the Click Leave Site event. Inherited from Control Leave Site.
OnContextMenuChanged Leave SiteRaises the ContextMenuChanged Leave Siteevent. Inherited from Control Leave Site.
OnControlAdded Leave SiteRaises the ControlAdded Leave Site event. Inherited from Control Leave Site.
OnControlRemoved Leave SiteRaises the ControlRemoved Leave Site event. Inherited from Control Leave Site.
OnCreateControl Leave SiteRaises the CreateControl Leave Site event. Inherited from Control Leave Site.
OnCursorButtonDownAllows derived classes to modify the default behavior of the CursorButtonDown event.
OnCursorButtonUpAllows derived classes to modify the default behavior of the CursorButtonUp event.
OnCursorChanged Leave SiteRaises the CursorChanged Leave Siteevent. Inherited from Control Leave Site.
OnCursorDownAllows derived classes to modify the default behavior of the CursorDown event.
OnCursorInRangeAllows derived classes to modify the default behavior of the CursorInRange event.
OnCursorOutOfRangeAllows derived classes to modify the default behavior of the CursorOutOfRange event.
OnDockChanged Leave SiteRaises the DockChanged Leave Siteevent. Inherited from Control Leave Site.
OnDoubleClick Leave SiteRaises the DoubleClick Leave Site event. Inherited from Control Leave Site.
OnDragDrop Leave SiteRaises the DragDrop Leave Site event. Inherited from Control Leave Site.
OnDragEnter Leave SiteRaises the DragEnter Leave Site event. Inherited from Control Leave Site.
OnDragLeave Leave SiteRaises the DragLeave Leave Site event. Inherited from Control Leave Site.
OnDragOver Leave SiteRaises the DragOver Leave Site event. Inherited from Control Leave Site.
OnEnabledChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
OnEnter Leave SiteRaises the Enter Leave Site event. Inherited from Control Leave Site.
OnFontChanged Leave SiteRaises the FontChanged Leave Siteevent. Inherited from Control Leave Site.
OnForeColorChanged Leave SiteRaises the ForeColorChanged Leave Siteevent. Inherited from Control Leave Site.
OnGestureAllows derived classes to modify the default behavior of the Gesture event.
OnGiveFeedback Leave SiteRaises the GiveFeedback Leave Site event. Inherited from Control Leave Site.
OnGotFocus Leave SiteRaises the GotFocus Leave Site event. Inherited from Control Leave Site.
OnHandleCreatedAllows derived classes to modify the default behavior of the HandleCreated Leave Site event.
OnHandleDestroyedAllows derived classes to modify the default behavior of the HandleDestroyed Leave Site event.
OnHelpRequested Leave SiteRaises the HelpRequested Leave Site event. Inherited from Control Leave Site.
OnImeModeChanged Leave SiteRaises the ImeModeChanged Leave Site event. Inherited from Control Leave Site.
OnInvalidated Leave SiteRaises the Invalidated Leave Site event. Inherited from Control Leave Site.
OnKeyDownAllows derived classes to modify the default behavior of the KeyDown Leave Site event.
OnKeyPress Leave SiteRaises the KeyPress Leave Site event. Inherited from Control Leave Site.
OnKeyUp Leave SiteRaises the KeyUp Leave Site event. Inherited from Control Leave Site.
OnLayout Leave SiteRaises the Layout Leave Site event. Inherited from Control Leave Site.
OnLeave Leave SiteRaises the Leave Leave Site event. Inherited from Control Leave Site.
OnLoadCompleted Leave Site Inherited from PictureBox Leave Site.
OnLoadProgressChanged Leave Site Inherited from PictureBox Leave Site.
OnLocationChanged Leave SiteRaises the LocationChanged Leave Site event. Inherited from Control Leave Site.
OnLostFocus Leave SiteRaises the LostFocus Leave Site event. Inherited from Control Leave Site.
OnMouseCaptureChanged Leave SiteRaises the MouseCaptureChanged Leave Site event. Inherited from Control Leave Site.
OnMouseClick Leave SiteRaises the MouseClick Leave Site event. Inherited from Control Leave Site.
OnMouseDoubleClick Leave SiteRaises the MouseDoubleClick Leave Site event. Inherited from Control Leave Site.
OnMouseDownAllows derived classes to modify the default behavior of the MouseDown Leave Site event.
OnMouseEnter Leave SiteRaises the MouseEnter Leave Site event. Inherited from Control Leave Site.
OnMouseHover Leave SiteRaises the MouseHover Leave Site event. Inherited from Control Leave Site.
OnMouseLeave Leave SiteRaises the MouseLeave Leave Site event. Inherited from Control Leave Site.
OnMouseMove Leave SiteRaises the MouseMove Leave Site event. Inherited from Control Leave Site.
OnMouseUp Leave SiteRaises the MouseUp Leave Site event. Inherited from Control Leave Site.
OnMouseWheel Leave SiteRaises the MouseWheel Leave Site event. Inherited from Control Leave Site.
OnMove Leave SiteRaises the Move Leave Site event. Inherited from Control Leave Site.
OnNewInAirPacketsAllows derived classes to modify the default behavior of the NewInAirPackets event.
OnNewPacketsAllows derived classes to modify the default behavior of the NewPackets event.
OnNotifyMessage Leave SiteNotifies the control of Windows messages. Inherited from Control Leave Site.
OnPaint Leave SiteOverridden onPaint to make sure that the image is painted correctly. Inherited from PictureBox Leave Site.
OnPaintBackground Leave SitePaints the background of the control. Inherited from Control Leave Site.
OnPaintedAllows derived classes to modify the default behavior of the Painted event.
OnPaintingAllows derived classes to modify the default behavior of the Painting event.
OnParentBackColorChanged Leave SiteRaises the BackColorChanged Leave Site event when the BackColor Leave Site property value of the control's container changes. Inherited from Control Leave Site.
OnParentBackgroundImageChanged Leave SiteRaises the BackgroundImageChanged Leave Site event when the BackgroundImage Leave Site property value of the control's container changes. Inherited from Control Leave Site.
OnParentBindingContextChanged Leave SiteRaises the BindingContextChanged Leave Site event when the BindingContext Leave Site property value of the control's container changes. Inherited from Control Leave Site.
OnParentChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
OnParentEnabledChanged Leave SiteRaises the EnabledChanged Leave Site event when the Enabled Leave Site property value of the control's container changes. Inherited from Control Leave Site.
OnParentFontChanged Leave SiteRaises the FontChanged Leave Site event when the Font Leave Site property value of the control's container changes. Inherited from Control Leave Site.
OnParentForeColorChanged Leave SiteRaises the ForeColorChanged Leave Site event when the ForeColor Leave Site property value of the control's container changes. Inherited from Control Leave Site.
OnParentRightToLeftChanged Leave SiteRaises the RightToLeftChanged Leave Site event when the RightToLeft Leave Site property value of the control's container changes. Inherited from Control Leave Site.
OnParentVisibleChanged Leave SiteRaises the VisibleChanged Leave Site event when the Visible Leave Site property value of the control's container changes. Inherited from Control Leave Site.
OnQueryContinueDrag Leave SiteRaises the QueryContinueDrag Leave Site event. Inherited from Control Leave Site.
OnResize Leave SiteOnResize override to invalidate entire control in Stetch mode Inherited from PictureBox Leave Site.
OnResizeBegin Leave SiteRaises the ResizeBegin Leave Site event. Inherited from Control Leave Site.
OnResizeEnd Leave SiteRaises the ResizeEnd Leave Site event. Inherited from Control Leave Site.
OnRightToLeftChanged Leave SiteRaises the RightToLeftChanged Leave Site event. Inherited from Control Leave Site.
OnSelectionChangedAllows derived classes to modify the default behavior of the SelectionChanged event.
OnSelectionChangingAllows derived classes to modify the default behavior of the SelectionChanging event.
OnSelectionMovedAllows derived classes to modify the default behavior of the SelectionMoved event.
OnSelectionMovingAllows derived classes to modify the default behavior of the SelectionMoving event.
OnSelectionResizedAllows derived classes to modify the default behavior of the SelectionResized event.
OnSelectionResizingAllows derived classes to modify the default behavior of the SelectionResizing event.
OnSizeChanged Leave SiteRaises the SizeChanged Leave Site event. Inherited from Control Leave Site.
OnSizeModeChanged Leave SiteRaises the SizeModeChanged Leave Site event. Inherited from PictureBox Leave Site.
OnStrokeAllows derived classes to modify the default behavior of the Stroke event.
OnStrokesDeletedAllows derived classes to modify the default behavior of the StrokesDeleted event.
OnStrokesDeletingAllows derived classes to modify the default behavior of the StrokesDeleting event.
OnStyleChanged Leave SiteRaises the StyleChanged Leave Site event. Inherited from Control Leave Site.
OnSystemColorsChanged Leave SiteRaises the SystemColorsChanged Leave Site event. Inherited from Control Leave Site.
OnSystemGestureAllows derived classes to modify the default behavior of the SystemGesture event.
OnTabIndexChanged Leave SiteRaises the TabIndexChanged Leave Site event. Inherited from Control Leave Site.
OnTabletAddedAllows derived classes to modify the default behavior of the TabletAdded event.
OnTabletRemovedAllows derived classes to modify the default behavior of the TabletRemoved event.
OnTabStopChanged Leave SiteRaises the TabStopChanged Leave Site event. Inherited from Control Leave Site.
OnTextChanged Leave SiteRaises the TextChanged Leave Site event. Inherited from Control Leave Site.
OnValidated Leave SiteRaises the Validated Leave Site event. Inherited from Control Leave Site.
OnValidating Leave SiteRaises the Validating Leave Site event. Inherited from Control Leave Site.
OnVisibleChanged Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
PerformLayout Leave SiteForces the control to apply layout logic to child controls. Inherited from Control Leave Site.
PointToClient Leave SiteComputes the location of the specified screen point into client coordinates. Inherited from Control Leave Site.
PointToScreen Leave SiteComputes the location of the specified client point into screen coordinates. Inherited from Control Leave Site.
PreProcessMessage Leave SitePreprocesses keyboard or input messages within the message loop before they are dispatched. Inherited from Control Leave Site.
ProcessCmdKey Leave SiteProcesses a command key. Inherited from Control Leave Site.
ProcessDialogChar Leave SiteProcesses a dialog character. Inherited from Control Leave Site.
ProcessDialogKey Leave SiteProcesses a dialog key. Inherited from Control Leave Site.
ProcessKeyEventArgs Leave SiteProcesses a key message and generates the appropriate control events. Inherited from Control Leave Site.
ProcessKeyMessage Leave SiteProcesses a keyboard message. Inherited from Control Leave Site.
ProcessKeyPreview Leave SitePreviews a keyboard message. Inherited from Control Leave Site.
ProcessMnemonic Leave SiteProcesses a mnemonic character. Inherited from Control Leave Site.
RaiseDragEvent Leave SiteRaises the appropriate drag event. Inherited from Control Leave Site.
RaiseKeyEvent Leave SiteRaises the appropriate key event. Inherited from Control Leave Site.
RaiseMouseEvent Leave SiteRaises the appropriate mouse event. Inherited from Control Leave Site.
RaisePaintEvent Leave SiteRaises the appropriate paint event. Inherited from Control Leave Site.
RecreateHandle Leave SiteForces the re-creation of the handle for the control. Inherited from Control Leave Site.
RectangleToClient Leave SiteComputes the size and location of the specified screen rectangle in client coordinates. Inherited from Control Leave Site.
RectangleToScreen Leave SiteComputes the size and location of the specified client rectangle in screen coordinates. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)ReferenceEquals Leave SiteDetermines whether the specified Object Leave Site instances are the same instance. Inherited from Object Leave Site.
static (Shared in Visual Basic .NET)ReflectMessage Leave SiteReflects the specified message to the control that is bound to the specified handle. Inherited from Control Leave Site.
Refresh Leave SiteForces the control to invalidate its client area and immediately redraw itself and any child controls. Inherited from Control Leave Site.
ResetBackColor Leave SiteResets the BackColor Leave Site property to its default value. Inherited from Control Leave Site.
ResetBindings Leave SiteResets the DataBindings Leave Site property to its default value. Inherited from Control Leave Site.
ResetCursor Leave SiteResets the Cursor Leave Site property to its default value. Inherited from Control Leave Site.
ResetFont Leave SiteResets the Font Leave Siteproperty to its default value. Inherited from Control Leave Site.
ResetForeColor Leave SiteResets the ForeColor Leave Site property to its default value. Inherited from Control Leave Site.
ResetImeMode Leave SiteResets the ImeMode Leave Site property to its default value. Inherited from Control Leave Site.
ResetMouseEventArgs Leave SiteResets the mouse leave listeners. Inherited from Control Leave Site.
ResetRightToLeft Leave SiteResets the RightToLeft Leave Site property to its default value. Inherited from Control Leave Site.
ResetText Leave SiteResets the Text Leave Site property to its default value. Inherited from Control Leave Site.
ResumeLayout Leave SiteResumes normal layout logic. Inherited from Control Leave Site.
RtlTranslateAlignment Leave SiteConverts the current alignment to the appropriate alignment to support right-to-left text. Inherited from Control Leave Site.
RtlTranslateContent Leave SiteConverts the specified ContentAlignment Leave Site to the appropriate ContentAlignment Leave Site to support right-to-left text. Inherited from Control Leave Site.
RtlTranslateHorizontal Leave SiteConverts the specified HorizontalAlignment Leave Site to the appropriate HorizontalAlignment Leave Site to support right-to-left text. Inherited from Control Leave Site.
RtlTranslateLeftRight Leave SiteConverts the specified LeftRightAlignment Leave Site to the appropriate LeftRightAlignment Leave Site to support right-to-left text. Inherited from Control Leave Site.
Scale Leave SiteScales the control and any child controls. Inherited from Control Leave Site.
ScaleCore Leave SitePerforms the work of scaling the entire control and any child controls. Inherited from Control Leave Site.
ScrollWindow Leave SiteScrolls the contents of the specified window's client area. Inherited from Control Leave Site.
Select Leave SiteActivates a control. Inherited from Control Leave Site.
SelectNextControl Leave SiteActivates the next control. Inherited from Control Leave Site.
SendToBack Leave SiteSends the control to the back of the z-order. Inherited from Control Leave Site.
SetAllTabletsModeSets the InkPicture control to collect ink from any tablet attached to the Tablet PC.
SetBounds Leave SiteSets the bounds of the control. Inherited from Control Leave Site.
SetBoundsCore Leave SiteOverrides Control.setBoundsCore to enforce autoSize. Inherited from PictureBox Leave Site.
SetClientSizeCore Leave SiteSets the size of the client area of the control. Inherited from Control Leave Site.
SetGestureStatusSets whether or not the InkPicture object has interest in a known application gesture.
SetSingleTabletIntegratedModeSets 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 Leave SiteSets the specified style bit to the specified value. Inherited from Control Leave Site.
SetTopLevel Leave SiteSets the control as the top-level control. Inherited from Control Leave Site.
SetVisibleCore Leave SiteSets the control to the specified visible state. Inherited from Control Leave Site.
SetWindowInputRectangleSets the window rectangle, in pixels, within which ink is drawn.
Show Leave SiteDisplays the control to the user. Inherited from Control Leave Site.
SuspendLayout Leave SiteTemporarily suspends the layout logic for the control. Inherited from Control Leave Site.
ToString Leave SiteReturns a string representation for this control. Inherited from PictureBox Leave Site.
Update Leave SiteCauses the control to redraw the invalidated regions within its client area. Inherited from Control Leave Site.
UpdateBounds Leave SiteUpdates the bounds of the control. Inherited from Control Leave Site.
UpdateStyles Leave SiteForces the assigned styles to be reapplied to the control. Inherited from Control Leave Site.
UpdateZOrder Leave SiteUpdates the control in its parent's z-order. Inherited from Control Leave Site.
WndProc Leave SiteProcesses Windows messages. Inherited from Control Leave Site.

Properties

PropertyDescription
AccessibilityObject Leave SiteGets the AccessibleObject Leave Site assigned to the control. Inherited from Control Leave Site.
AccessibleDefaultActionDescription Leave SiteGets or sets the default action description of the control for use by accessibility client applications. Inherited from Control Leave Site.
AccessibleDescription Leave SiteGets or sets the description of the control used by accessibility client applications. Inherited from Control Leave Site.
AccessibleName Leave SiteGets or sets the name of the control used by accessibility client applications. Inherited from Control Leave Site.
AccessibleRole Leave SiteGets or sets the accessible role of the control Inherited from Control Leave Site.
AllowDrop Leave Site Inherited from PictureBox Leave Site.
Anchor Leave SiteGets or sets which edges of the control are anchored to the edges of its container. Inherited from Control Leave Site.
AutoRedrawGets or sets a value that specifies whether the InkPicture control repaints the ink when the window is invalidated.
AutoSize Leave Site[To be supplied.] Inherited from Control Leave Site.
BackColor Leave SiteGets or sets the background color for the control. Inherited from Control Leave Site.
BackgroundImage Leave SiteGets or sets the background image displayed in the control. Inherited from Control Leave Site.
BackgroundImageLayout Leave SiteGets or sets the background image layout as defined in the ImageLayout Leave Site enumeration. Inherited from Control Leave Site.
BindingContext Leave SiteGets or sets the BindingContext Leave Site for the control. Inherited from Control Leave Site.
BorderStyle Leave SiteIndicates the border style for the control. Inherited from PictureBox Leave Site.
Bottom Leave SiteGets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area. Inherited from Control Leave Site.
Bounds Leave SiteGets or sets the size and location of the control including its nonclient elements. Inherited from Control Leave Site.
CanFocus Leave SiteGets a value indicating whether the control can receive focus. Inherited from Control Leave Site.
CanRaiseEvents Leave SiteDetermines if events can be fired on the control. Inherited from Control Leave Site.
CanSelect Leave SiteGets a value indicating whether the control can be selected. Inherited from Control Leave Site.
Capture Leave SiteGets or sets a value indicating whether the control has captured the mouse. Inherited from Control Leave Site.
CausesValidation Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
static (Shared in Visual Basic .NET)CheckForIllegalCrossThreadCalls Leave SiteGets or sets a value indicating whether to catch calls on the wrong thread that access a control's Handle Leave Site property. Inherited from Control Leave Site.
ClientRectangle Leave SiteGets the rectangle that represents the client area of the control. Inherited from Control Leave Site.
ClientSize Leave SiteGets or sets the height and width of the client area of the control. Inherited from Control Leave Site.
CollectingInkGets a value that specifies whether ink is currently being drawn on an InkPicture control.
CollectionModeGets or sets the collection mode that determines whether ink, gestures, or both are recognized as the user writes.
CompanyName Leave SiteGets the name of the company or creator of the application containing the control. Inherited from Control Leave Site.
Container Leave Site Inherited from Component Leave Site.
ContainsFocus Leave SiteGets a value indicating whether the control, or one of its child controls, currently has the input focus. Inherited from Control Leave Site.
ContextMenu Leave SiteGets or sets the shortcut menu associated with the control. Inherited from Control Leave Site.
Controls Leave SiteGets the collection of controls contained within the control. Inherited from Control Leave Site.
Created Leave SiteGets a value indicating whether the control has been created. Inherited from Control Leave Site.
CreateParams Leave SiteReturns 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 Leave Site.
CursorGets or sets the cursor that appears when the mouse pointer is over the InkPicture control.
CursorsGets the Cursors collection that is available for use in the inking region.
DataBindings Leave SiteGets the data bindings for the control. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)DefaultBackColor Leave SiteGets the default background color of the control. Inherited from Control Leave Site.
DefaultCursor Leave SiteGets or sets the default cursor for the control. Inherited from Control Leave Site.
DefaultDrawingAttributesGets or sets the default DrawingAttributes object, which specifies the drawing attributes that are used when drawing and displaying ink.
static (Shared in Visual Basic .NET)DefaultFont Leave SiteGets the default font of the control. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)DefaultForeColor Leave SiteGets the default foreground color of the control. Inherited from Control Leave Site.
DefaultImeMode Leave SiteGets a value indicating the mode for Input Method Editor (IME) for the PictureBox Leave Site . Inherited from PictureBox Leave Site.
DefaultSize Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
DesignMode Leave Site Inherited from Component Leave Site.
DesiredPacketDescriptionGets or sets interest in aspects of the packets associated with ink drawn on the InkPicture object.
DisplayRectangle Leave SiteGets the rectangle that represents the display area of the control. Inherited from Control Leave Site.
DisposingGets a value that indicates whether the InkPicture control is being disposed of.
Dock Leave SiteGets or sets which edge of the parent container a control is docked to. Inherited from Control Leave Site.
DoubleBuffered Leave SiteGets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. Inherited from Control Leave Site.
DynamicRenderingGets or sets a value that indicates whether ink is rendered as it is drawn.
EditingModeGets or sets a value that indicates whether the InkPicture is in ink mode, delete mode, or select/edit mode.
Enabled Leave SiteGets or sets a value indicating whether the control can respond to user interaction. Inherited from Control Leave Site.
EraserModeGets or sets a value that indicates whether ink is erased by stroke or by point.
EraserWidthGets or sets a value that specifies the width of the eraser pen tip.
ErrorImage Leave Site Inherited from PictureBox Leave Site.
Events Leave Site Inherited from Component Leave Site.
Focused Leave SiteGets a value indicating whether the control has input focus. Inherited from Control Leave Site.
Font Leave Site Inherited from PictureBox Leave Site.
FontHeight Leave SiteGets or sets the height of the font of the control. Inherited from Control Leave Site.
ForeColor Leave Site Inherited from PictureBox Leave Site.
Handle Leave SiteGets the window handle that the control is bound to. Inherited from Control Leave Site.
HasChildren Leave SiteGets a value indicating whether the control contains one or more child controls. Inherited from Control Leave Site.
Height Leave SiteGets or sets the height of the control. Inherited from Control Leave Site.
Image Leave SiteGets or sets the image that the PictureBox Leave Site displays. Inherited from PictureBox Leave Site.
ImageLocation Leave Site Inherited from PictureBox Leave Site.
ImeMode Leave SiteGets or sets the Input Method Editor(IME) mode supported by this control. Inherited from PictureBox Leave Site.
InitialImage Leave Site Inherited from PictureBox Leave Site.
InkGets or sets the Ink object that is associated with the InkPicture object.
InkEnabledGets or sets a value that specifies whether the InkPicture control collects pen input.
InvokeRequired Leave SiteGets 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 Leave Site.
IsAccessible Leave SiteGets or sets a value indicating whether the control is visible to accessibility applications. Inherited from Control Leave Site.
IsDisposed Leave SiteGets a value indicating whether the control has been disposed of. Inherited from Control Leave Site.
IsHandleCreated Leave SiteGets a value indicating whether the control has a handle associated with it. Inherited from Control Leave Site.
LayoutEngine Leave SiteGets a cached instance of the control's layout engine. Inherited from Control Leave Site.
Left Leave SiteGets 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 Leave Site.
LoadProgress Leave Site Inherited from PictureBox Leave Site.
Location Leave SiteGets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. Inherited from Control Leave Site.
Margin Leave SiteGets or sets the space between controls. Inherited from Control Leave Site.
MarginXGets or sets the margins along the x-axis, in pixels.
MarginYGets or sets the margins along the y-axis, in pixels.
MaximumSize Leave Site[To be supplied.] Inherited from Control Leave Site.
MinimumSize Leave SiteGets the size that is the lower limit that GetPreferredSize Leave Site can specify. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)ModifierKeys Leave SiteGets a value indicating which of the modifier keys (SHIFT, CTRL, and ALT) is in a pressed state. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)MouseButtons Leave SiteGets a value indicating which of the mouse buttons is in a pressed state. Inherited from Control Leave Site.
static (Shared in Visual Basic .NET)MousePosition Leave SiteGets the position of the mouse cursor in screen coordinates. Inherited from Control Leave Site.
Name Leave SiteGets or sets the name of the control. Inherited from Control Leave Site.
Padding Leave SiteGets or sets padding within the control. Inherited from Control Leave Site.
Parent Leave SiteGets or sets the parent container of the control. Inherited from Control Leave Site.
Pinned Leave SiteGets or sets a value indicating whether the control can be automatically resized and will move other controls during layout. Inherited from Control Leave Site.
PreferredSize Leave Site[To be supplied.] Inherited from Control Leave Site.
ProductName Leave SiteGets the product name of the assembly containing the control. Inherited from Control Leave Site.
ProductVersion Leave SiteGets the version of the assembly containing the control. Inherited from Control Leave Site.
RecreatingHandle Leave SiteGets a value indicating whether the control is currently re-creating its handle. Inherited from Control Leave Site.
Region Leave SiteGets or sets the window region associated with the control. Inherited from Control Leave Site.
RendererGets or sets the Renderer object that is used to draw ink.
RenderRightToLeft Leave Site Inherited from Control Leave Site.
ResizeRedraw Leave SiteGets or sets a value indicating whether the control redraws itself when resized. Inherited from Control Leave Site.
Right Leave SiteGets the distance, in pixels, between the right edge of the control and the left edge of its container's client area. Inherited from Control Leave Site.
RightToLeft Leave Site Inherited from PictureBox Leave Site.
SelectionGets or sets the Strokes collection that is currently selected inside the InkPicture control.
ShowFocusCues Leave SiteGets a value indicating whether the control should display focus rectangles. Inherited from Control Leave Site.
ShowKeyboardCues Leave SiteGets a value indicating whether the control should display keyboard shortcuts. Inherited from Control Leave Site.
Site Leave SiteGets or sets the site of the control. Inherited from Control Leave Site.
Size Leave SiteGets or sets the height and width of the control. Inherited from Control Leave Site.
SizeMode Leave SiteIndicates how the image is displayed. Inherited from PictureBox Leave Site.
SupportHighContrastInkGets or sets a value that specifies whether ink is rendered as just one color when the system is in High Contrast mode.
SupportHighContrastSelectionUIGets 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 Leave Site[To be supplied.] Inherited from PictureBox Leave Site.
TabletGets the tablet device that the InkPicture control is currently using to collect input.
TabStopGets or sets a value indicating whether the user can give the focus to this control by pressing the TAB key.
Tag Leave SiteGets or sets the object that contains data about the control. Inherited from Control Leave Site.
Text Leave Site Inherited from PictureBox Leave Site.
Top Leave SiteGets 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 Leave Site.
TopLevelControl Leave SiteGets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form Leave Site that the control is contained in. Inherited from Control Leave Site.
UseWaitCursor Leave SiteGets or sets a value indicating whether to use the wait cursor for the current control and all child controls. Inherited from Control Leave Site.
Visible Leave SiteGets or sets a value indicating whether the control is displayed. Inherited from Control Leave Site.
WaitOnLoad Leave Site Inherited from PictureBox Leave Site.
Width Leave SiteGets or sets the width of the control. Inherited from Control Leave Site.
WindowTarget Leave SiteThe target of Win32 window messages. Inherited from Control Leave Site.

Inheritance Hierarchy

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.

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

Class Information

NamespaceMicrosoft.Ink
AssemblyMicrosoft.Ink (microsoft.ink.dll)
Strong NameMicrosoft.Ink, Version=1.7.4009.0, Culture=neutral, PublicKeyToken=a2870d9cc4d021c8

See Also

Page view tracker