SizeGripItem
Provides an interactive grip that resizes its hosting control by dragging.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class SizeGripItem : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemSizeGripItem...
Implements:
Inherited Members
Constructors
public SizeGripItem()
Properties
Gets or sets a boolean value that determines whether the SizeGripItem can resize the hosting control.
public bool AllowSizing { get; set; }
Gets the primitive that renders the grip's glyph image.
public ImagePrimitive Image { get; }
Gets or sets whether the grip is laid out for right-to-left content; setting this rotates the grip's glyph by 90 degrees to mirror its resize-direction cue instead of changing its alignment.
public override bool RightToLeft { get; set; }
Overrides:
Gets or sets whether the hosting control's minimum size is included when calculating the grip's resize limit.
[Browsable(false)]
public bool ShouldAspectMinSize { get; set; }
Gets or sets whether the minimum size is based on the root element's desired size.
[Browsable(false)]
public bool ShouldAspectRootElement { get; set; }
Gets or sets which mouse-drag axes resize the hosting control: Horizontal, Vertical, or Both.
public SizeGripItem.SizingModes SizingMode { get; set; }
Methods
Creates the fill, border, and image primitives that render the grip.
protected override void CreateChildElements()
Overrides:
Updates the grip image's mirrored orientation when the layout direction changes, then performs the base measurement.
Starts a resize drag by recording the control's original bounds, raising Sizing, and capturing the mouse.
protected override void OnMouseDown(MouseEventArgs e)
The mouse event data for the press.
Overrides:
Sets the cursor to indicate the resize direction, accounting for the grip's orientation and right-to-left layout.
protected override void OnMouseEnter(EventArgs e)
The event data for pointer entry.
Overrides:
Restores the standard arrow cursor when the pointer leaves the grip.
protected override void OnMouseLeave(EventArgs e)
The event data for pointer exit.
Overrides:
Resizes the hosting control while this grip is active and the left mouse button is held, constrained by the configured axes and size limits.
protected override void OnMouseMove(MouseEventArgs e)
The mouse event data for the current pointer movement.
Overrides:
Ends the active resize drag, releases mouse capture, and restores the control cursor.
protected override void OnMouseUp(MouseEventArgs e)
The mouse event data for the release.
Overrides:
Raises Sized after the hosting control has been resized.
protected virtual void OnSized(object sender, ValueChangingEventArgs args)
The grip item that performed the resize.
argsValueChangingEventArgsThe resize delta supplied by the mouse movement.
Raises Sizing when a resize drag begins, before changing the hosting control's size.
protected virtual void OnSizing(object sender, ValueChangingEventArgs args)
The grip item starting the resize.
argsValueChangingEventArgsThe pointer position at the start of the drag.
Events
Occurs after the hosting control has been resized as a result of dragging this grip.
public event ValueChangingEventHandler Sized
Occurs when the user starts dragging this grip, before any resizing is applied.
public event ValueChangingEventHandler Sizing