New to Telerik UI for WinForms? Start a free 30-day trial

Positions comment balloons and the comments pane alongside annotation markers in the current view.

Definition

Namespace:Telerik.WinForms.Documents.UI.Layers

Assembly:Telerik.WinControls.RichTextEditor.dll

Syntax:

C#
public class CommentsUILayer : IUILayer

Inheritance: objectCommentsUILayer

Implements: IUILayer

Constructors

Initializes the comments layer for the specified presenter.

C#
public CommentsUILayer(IUILayerContainer pagePresenter)
Parameters:pagePresenterIUILayerContainer

The presenter that owns the comments layer.

Properties

Gets the most recently supplied layer-update context.

C#
public UILayerUpdateContext CurrentUpdateContext { get; }

Gets or sets whether comment visuals in the layer's canvas participate in hit testing; this does not affect the comments pane.

C#
public bool IsHitTestVisible { get; set; }

Implements: IUILayer.IsHitTestVisible

Gets the identifier used to register the comments layer.

C#
public virtual string Name { get; }

Implements: IUILayer.Name

Gets the object pool used to create and release comment visuals.

C#
protected ObjectPool ObjectPool { get; }

Gets the comment annotation markers in the current page, or across the document for web layout.

C#
public virtual IEnumerable<AnnotationMarkerLayoutBox> ProvidersEnumerable { get; }

Gets whether the presenter clips this layer to the displayed section's bounds; this layer returns false.

C#
public virtual bool ShouldClip { get; }

Implements: IUILayer.ShouldClip

Gets whether this layer updates for viewport changes when it is not invalidated; the layer returns false.

C#
public virtual bool ShouldUpdateWhenNotInvalidated { get; }

Implements: IUILayer.ShouldUpdateWhenNotInvalidated

Offset of the view from the initial point (0, 0) generally related to scroll offset

C#
public PointF ViewOffset { get; }

Gets whether the view offset changed during the most recent viewport update.

C#
protected bool ViewOffsetChanged { get; }

Gets the rectangle currently visible

C#
protected RectangleF ViewPort { get; }

Gets whether the viewport rectangle changed during the most recent viewport update.

C#
protected bool ViewportChanged { get; }

Methods

Adds a comment visual, first removing it from another comments layer when necessary.

C#
public void AddChild(FrameworkElement uiElement)
Parameters:uiElementFrameworkElement

The comment visual to add.

Positions the comments pane and comment balloons for the visible section boxes.

C#
public void ArrangeChildren()

Implements: IUILayer.ArrangeChildren()

Unregisters and releases all comment visuals and clears tracked layout boxes.

C#
public void ClearChildren()

Implements: IUILayer.ClearChildren()

Invalidates comments-pane measurement and the editor layout of visible comment balloons.

C#
public void DoOnPresentationChanged()

Implements: IUILayer.DoOnPresentationChanged()

Gets the root visual containing the comments pane and comment balloons.

C#
public UIElement GetLayerUIElement()
Returns:

UIElement

The canvas representing this layer.

Implements: IUILayer.GetLayerUIElement()

Unregisters a comment visual and removes it from the layer's canvas.

C#
public void RemoveChild(FrameworkElement existingElement)
Parameters:existingElementFrameworkElement

The comment visual to remove.

Removes a visual's association with its annotation marker and notifies its comment provider.

C#
public void UnregisterChildUIElement(FrameworkElement existingElement)
Parameters:existingElementFrameworkElement

The comment visual being detached.

Lays out the comments pane and creates, updates, or removes visible comment balloons.

C#
protected virtual void UpdateUI()

Updates the view offset, visible rectangle, and object pool used by subsequent comment layout.

C#
public void UpdateViewPort(PointF viewOffset, RectangleF viewPort, ObjectPool uiElementPool)
Parameters:viewOffsetPointF

The document-space offset of the view.

viewPortRectangleF

The visible rectangle in document coordinates.

uiElementPoolObjectPool

The pool used for comment visuals.

Recalculates visible comment visuals for the specified finite viewport.

C#
public void UpdateViewPort(RectangleF viewPort)
Parameters:viewPortRectangleF

The visible rectangle in document coordinates.

Stores the current presenter context and updates comment visuals for its viewport.

C#
public void UpdateViewPort(UILayerUpdateContext context)
Parameters:contextUILayerUpdateContext

The current layer-update context.

Implements: IUILayer.UpdateViewPort(UILayerUpdateContext)