AnnotationHelper.CreateInkStickyNoteForSelection Method

Reference

Definition

Namespace:: System.Windows.Annotations

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Creates an ink sticky note annotation on the current selection of the viewer control associated with the specified AnnotationService.

public:
 static System::Windows::Annotations::Annotation ^ CreateInkStickyNoteForSelection(System::Windows::Annotations::AnnotationService ^ service, System::String ^ author);

public static System.Windows.Annotations.Annotation CreateInkStickyNoteForSelection (System.Windows.Annotations.AnnotationService service, string author);

static member CreateInkStickyNoteForSelection : System.Windows.Annotations.AnnotationService * string -> System.Windows.Annotations.Annotation

Public Shared Function CreateInkStickyNoteForSelection (service As AnnotationService, author As String) As Annotation

Parameters

service: AnnotationService

The annotation service to use to create the ink sticky note annotation.

author: String

The author of the annotation.

Returns

Annotation

The ink sticky note annotation; or null, if there is no selected content to annotate.

Exceptions

ArgumentNullException

service is null.

ArgumentException

service is not enabled.

InvalidOperationException

The viewer control contains no content selection.

Remarks

The ink sticky note annotation is anchored to the content defined by the current selection of the DocumentViewerBase, DocumentViewer, FlowDocumentPageViewer, FlowDocumentScrollViewer, or FlowDocumentReader control specified to the AnnotationService constructor.

If there is no user-selected content (the selection length is zero length), no annotation is created and an InvalidOperationException is thrown.

author can be specified as null in which case no author is defined.

The given annotation service must be enabled by means of a call to AnnotationService.Enable prior to calling CreateInkStickyNoteForSelection.

Applies to