Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

Represents an object that is useful for annotation scenarios where users are not concerned with performing recognition on ink but instead are interested in the size, shape, color, and position of the ink.

The IInkOverlayobject is well suited for note taking and basic scribbling. The primary intended use of this object is to display ink as ink.

In general, the run-time user interface for this object is a transparent window with opaque ink.

The MouseDown, MouseMove, and MouseUpevents return x– and y–coordinates in pixels, and not the HIMETRIC units that are associated with the ink space. This is because these events replace the mouse events of pen–unaware applications and these applications understand only pixels.

To improve your application's performance, dispose your IInkOverlayobject when it is no longer needed.

In This Section

IInkOverlay Methods

Describes the methods available for IInkOverlay.

IInkOverlay Properties

Describes the properties available for IInkOverlay.

MFC Implementation Notes

If you attached the InkOverlay object to a CView object, release the InkOverlay object in response to the WM_DESTROYmessage as shown in the following example:

Copy Code 
BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM
wp, PARAM lp, LRESULT *pLR)
{
  if(WM_DESTROY == msg)
	m_spInkOverlay.Release();
  return CView::OnWndMsg(msg, wp, lp, pLR);
}

See Also