AnnotationHelper.CreateHighlightForSelection Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает пометку маркером для текущего выделения в элементе управления, предназначенном для просмотра документов, который связан с заданным объектом 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
Кисть, которая должна использоваться для рисования поверх выделенного содержимого.
Возвращаемое значение
Пометка маркером или null, если содержимое для пометки не выделено.
Исключения
service имеет значение null.
Служба service не включена.
-или-
Параметр highlightBrush не является SolidColorBrush.
Элемент управления, предназначенный для просмотра документов, не содержит выделенного содержимого.
Комментарии
Заметка выделения привязана к содержимому, определенному текущим выбранным элементом DocumentViewerBase, FlowDocumentPageViewerDocumentViewerFlowDocumentScrollViewerили FlowDocumentReader элементом управления, указанным конструктору.AnnotationService
Если выделенное содержимое отсутствует (длина выделенного фрагмента равна нулю), заметка не создается и InvalidOperationException создается исключение.
author можно указать так, как null в этом случае автор не определен.
Если highlightBrush это nullтак, используется кисть выделения по умолчанию данной заметки service .
Данная заметка service должна быть включена с помощью вызова AnnotationService.Enable перед вызовом CreateHighlightForSelection.