AnnotationHelper.CreateHighlightForSelection 方法

定義

命名空間:

System.Windows.Annotations

組件:

PresentationFramework.dll

在與指定 AnnotationService 關聯之檢視器控制項的目前選取範圍上建立反白顯示附註。

public:
 static System::Windows::Annotations::Annotation ^ CreateHighlightForSelection(System::Windows::Annotations::AnnotationService ^ service, System::String ^ author, System::Windows::Media::Brush ^ highlightBrush);

public static System.Windows.Annotations.Annotation CreateHighlightForSelection (System.Windows.Annotations.AnnotationService service, string author, System.Windows.Media.Brush highlightBrush);

static member CreateHighlightForSelection : System.Windows.Annotations.AnnotationService * string * System.Windows.Media.Brush -> System.Windows.Annotations.Annotation

Public Shared Function CreateHighlightForSelection (service As AnnotationService, author As String, highlightBrush As Brush) As Annotation

參數

service

AnnotationService

附註服務可用來建立反白顯示附註。

author

String

附註作者。

highlightBrush

Brush

用來在選取的內容上繪製反白顯示的筆刷。

傳回

Annotation

反白顯示附註；如果沒有選取的內容可繪製反白顯示則為 null。

例外狀況

ArgumentNullException

service 為 null。

ArgumentException

service 未啟用。

-或- highlightBrush 不是 SolidColorBrush。

InvalidOperationException

檢視器控制項內不含內容選取範圍。

備註

醒目提示注釋會錨定在建構函式所指定 AnnotationService 之 、 DocumentViewer 、 FlowDocumentPageViewer 、 FlowDocumentScrollViewer 或 FlowDocumentReader 控制項的目前選取範圍 DocumentViewerBase 所定義的內容。

如果沒有選取的內容 (選取長度為零長度) ，則不會建立注釋，而且 InvalidOperationException 會擲回 。

author 可以指定為 null 未定義作者的情況。

如果 highlightBrush 為 null ，則會使用指定注釋的預設醒目提示 service 筆刷。

在呼叫 CreateHighlightForSelection 之前，必須透過 呼叫 AnnotationService.Enable 來啟用指定的批註 service 。

另請參閱

• ClearHighlightsForSelection(AnnotationService)
• CreateHighlightCommand