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.