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

Hosts a RadElement in a non-activating popup and animates its scale; after hiding, it restores the element's original parent and layout settings when that parent remains valid.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
[RadToolboxItem(false)]
public class ZoomPopup : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, IMessageListener

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlZoomPopup...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetILayoutHandlerIMessageListenerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISynchronizeInvokeIWin32Window...

Inherited Members RadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Dispose(bool)RadControl.Construct()RadControl.CreateBehavior()RadControl.CreateRootElement()RadControl.InitializeRootElement(RootRadElement)RadControl.LoadElementTree()RadControl.LoadElementTree(Size)RadControl.SetBackColorThemeOverrides()RadControl.ResetBackColorThemeOverrides()RadControl.SetForeColorThemeOverrides()RadControl.ResetForeColorThemeOverrides()RadControl.OnKeyDown(KeyEventArgs)RadControl.OnKeyUp(KeyEventArgs)RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)RadControl.OnKeyPress(KeyPressEventArgs)RadControl.OnClick(EventArgs)RadControl.OnDoubleClick(EventArgs)RadControl.OnMouseDown(MouseEventArgs)RadControl.OnMouseUp(MouseEventArgs)RadControl.OnMouseEnter(EventArgs)RadControl.OnMouseLeave(EventArgs)RadControl.OnMouseMove(MouseEventArgs)RadControl.OnMouseHover(EventArgs)RadControl.OnMouseWheel(MouseEventArgs)RadControl.OnMouseCaptureChanged(EventArgs)RadControl.OnGotFocus(EventArgs)RadControl.OnLostFocus(EventArgs)RadControl.OnCreateControl()RadControl.OnHandleDestroyed(EventArgs)RadControl.OnParentChanged(EventArgs)RadControl.OnVisibleChanged(EventArgs)RadControl.OnFontChanged(EventArgs)RadControl.OnForeColorChanged(EventArgs)RadControl.OnBackColorChanged(EventArgs)RadControl.OnEnabledChanged(EventArgs)RadControl.OnBindingContextChanged(EventArgs)RadControl.OnLocationChanged(EventArgs)RadControl.OnPaddingChanged(EventArgs)RadControl.OnRightToLeftChanged(EventArgs)RadControl.OnPaint(PaintEventArgs)RadControl.OnLayout(LayoutEventArgs)RadControl.OnAutoSizeChanged(EventArgs)RadControl.OnInvalidated(RadElement)RadControl.OnLoad(Size)RadControl.OnCaptureLosing()RadControl.OnThemeChanged()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)RadControl.ProcessMnemonic(char)RadControl.ProcessAutoSizeChanged(bool)RadControl.IsInputKey(Keys)RadControl.GetInputElement()RadControl.BeginInit()RadControl.EndInit()RadControl.OnNotifyPropertyChanged(string)RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadControl.GetPreferredSize(Size)RadControl.SetBoundsCore(int, int, int, int, BoundsSpecified)RadControl.GetRootElementDesiredSize(int, int, int, int)RadControl.OnZoomGesture(ZoomGestureEventArgs)RadControl.OnRotateGesture(RotateGestureEventArgs)RadControl.OnPanGesture(PanGestureEventArgs)RadControl.OnTwoFingerTapGesture(GestureEventArgs)RadControl.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadControl.OnGesture(GestureEventArgs)RadControl.ProcessGesture(Message)RadControl.EnableGesture(GestureType)RadControl.DisableGesture(GestureType)RadControl.Refresh()RadControl.SuspendUpdate()RadControl.ResumeUpdate()RadControl.ResumeUpdate(bool)RadControl.InvokeLayoutCallback(LayoutCallback)RadControl.RegisterHostedControl(RadHostItem)RadControl.UnregisterHostedControl(RadHostItem, bool)RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)RadControl.GetPlainText()RadControl.ShouldSerializeProperty(RadProperty)RadControl.ShouldSerializeProperty(RadProperty, RadObject)RadControl.ResetProperty(RadProperty, RadObject)RadControl.CanEditElementAtDesignTime(RadElement)RadControl.ProcessCodedUIMessage(ref IPCMessage)RadControl.FindPropertyInChildren(RadControl, IPCMessage)RadControl.ScaleControl(SizeF, BoundsSpecified)RadControl.PerformRadAutoScale(BoundsSpecified?)RadControl.GetMonitorDpiScaleFactor(Control)RadControl.SetRadAutoScale(bool)RadControl.EnableDpiScalingRadControl.EnableRadAutoScaleRadControl.EnableRadFormInitialDpiScalingRadControl.EnableImageDpiScalingRadControl.EnableSvgImagesRadControl.IsLoadedRadControl.ElementTreeRadControl.UseCompatibleTextRenderingDefaultValueRadControl.BehaviorRadControl.RootElementRadControl.PaddingRadControl.ThemeNameRadControl.TextRadControl.EnableThemingRadControl.ThemeClassNameRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.AutoSizeRadControl.MaximumSizeRadControl.MinimumSizeRadControl.FocusableRadControl.SiteRadControl.CausesValidationRadControl.IsInitializingRadControl.SmallImageListRadControl.SmallImageScalingSizeRadControl.IsDesignModeRadControl.IsDisplayedRadControl.FocusedElementRadControl.AllowShowFocusCuesRadControl.ShowItemToolTipsRadControl.CommandBindingsRadControl.EnableKeyMapRadControl.BackColorRadControl.ForeColorRadControl.FontRadControl.ValidationCancelRadControl.EnableAnalyticsRadControl.AnalyticsNameRadControl.EnableRadAccessibilityObjectsRadControl.EnableCodedUITestsRadControl.EnableCodedUITestsDefaultValueRadControl.EnableUIAutomationRadControl.EnableUIAutomationDefaultValueRadControl.ElementInvalidatedRadControl.ToolTipTextNeededRadControl.ScreenTipNeededRadControl.ThemeNameChangedRadControl.InitializedRadControl.PropertyChangedRadControl.ZoomGestureRadControl.RotateGestureRadControl.PanGestureRadControl.TwoFingerTapGestureRadControl.PressAndTapGesture...

Constructors

Creates a zoom popup that animates the element to the supplied target scale.

C#
public ZoomPopup(RadElement element, SizeF zoomFactor, bool waitForAnimationFinished)
Parameters:elementRadElement

The attached element to host temporarily in the popup.

zoomFactorSizeF

The target scale applied during the opening animation.

waitForAnimationFinishedbool

Stored but not read by the current implementation.

Creates a zoom popup with an optional starting rectangle and the supplied target scale.

C#
public ZoomPopup(RadElement element, SizeF zoomFactor, Rectangle initialBounds, bool waitForAnimationFinished)
Parameters:elementRadElement

The attached element to host temporarily in the popup.

zoomFactorSizeF

The target scale applied during the opening animation.

initialBoundsRectangle

The popup's starting bounds in screen coordinates; Empty uses the element's current bounds.

waitForAnimationFinishedbool

Stored but not read by the current implementation.

Creates a zoom popup using the element's current on-screen bounds and the supplied target scale.

C#
public ZoomPopup(RadElement element, SizeF zoomFactor)
Parameters:elementRadElement

The attached element to host temporarily in the popup.

zoomFactorSizeF

The target scale applied during the opening animation.

Fields

Raised after the hosted RadItem is clicked and the popup closes.

C#
public EventHandler Clicked

Raised after a loaded popup is hidden and restoration of the hosted element has been attempted; restoration is skipped if its original parent is no longer valid.

C#
public EventHandler Closed

Properties

Gets or sets the animation frames count

C#
[Browsable(true)]
public int AnimationFrames { get; set; }

Gets or sets the animation interval (in miliseconds)

C#
[Browsable(true)]
public int AnimationInterval { get; set; }

Configures the popup as non-activating and enables the native shadow when supported and HasShadow is true.

C#
protected override CreateParams CreateParams { get; }

Overrides: ScrollableControl.CreateParams

Gets or sets the zoom popup shadow

C#
[Browsable(true)]
public bool HasShadow { get; set; }

Methods

Temporarily reparents the source element into the popup and saves its original layout state for restoration.

C#
protected override void CreateChildItems(RadElement parent)
Parameters:parentRadElement

The popup root element that will host the source element.

Overrides: RadControl.CreateChildItems(RadElement)

Declines capture-change requests from elements hosted in the popup.

C#
protected override bool ProcessCaptureChangeRequested(RadElement element, bool capture)
Parameters:elementRadElement

The element requesting a capture change.

capturebool

Whether the element is requesting capture or release.

Returns:

bool

false for every request.

Overrides: RadControl.ProcessCaptureChangeRequested(RadElement, bool)

Declines focus requests from elements hosted in the popup.

C#
protected override bool ProcessFocusRequested(RadElement element)
Parameters:elementRadElement

The element requesting focus.

Returns:

bool

false because the popup does not approve focus requests.

Overrides: RadControl.ProcessFocusRequested(RadElement)

Attempts to restore the hosted element and raises the close callbacks when a loaded popup is hidden.

C#
protected override void SetVisibleCore(bool value)
Parameters:valuebool

The requested visibility state.

Overrides: Control.SetVisibleCore(bool)

Shows the popup without activating it and starts the element's scale animation.

C#
public void Show()

Returns a no-activate response to mouse-activation messages, hides on application-activation messages, and suppresses left, middle, and right button down, up, and double-click messages during the animation.

C#
protected override void WndProc(ref Message m)
Parameters:mMessage

The Windows message being processed.

Overrides: RadControl.WndProc(ref Message)