Class

RadPopupControlBase

Creates an instance of the RadPopupFormBase class.

Declaration

public RadPopupControlBase(RadElement owner)

Parameters

Declaration

public RadPopupControlBase.PopupAnimationProperties AnimationProperties

Field Value

Declaration

protected SizeF dpiScaleFactor

Field Value

Declaration

protected Rectangle lastAlignmentRectangle

Field Value

Gets or sets a value from the AlignmentRectangleOverlapMode which defines how the popup will be positioned according to the alignment rectangle when its location cannot be adjusted so that it meets all popup alignment and alignment correction mode requirements.

Declaration

public AlternativeCorrectionMode AlignmentRectangleOverlapMode { get; set; }

Property Value

Gets or sets a bool value determining whether popup animation is enabled.

Declaration

public bool AnimationEnabled { get; set; }

Property Value

Gets or sets the count of the frames of the drop down animation.

Declaration

public int AnimationFrames { get; set; }

Property Value

Gets or sets a value determining what animation type to use when showing the popup.

Declaration

public PopupAnimationTypes AnimationType { get; set; }

Property Value

Gets a List<T> instance that represents a collection of logical children of this IPopupControl. The OwnerPopup property of these children would point to this IPopupControl instance.

Declaration

public List<IPopupControl> Children { get; }

Property Value

Implements IPopupControl.Children

Declaration

protected override CreateParams CreateParams { get; }

Property Value

Overrides ScrollableControl.CreateParams

Gets or sets the direction of the drop-down animation.

Declaration

public RadDirection DropDownAnimationDirection { get; set; }

Property Value

Gets or sets a boolean value which determines whether the popup drops a shadow.

Declaration

public bool DropShadow { get; set; }

Property Value

Gets or sets the easing type for the drop down animations.

Declaration

public RadEasingType EasingType { get; set; }

Property Value

Enables the support for Windows Vista DWM effects.

Declaration

public bool EnableAeroEffects { get; set; }

Property Value

Gets or sets the frame count for the fade animation.

Declaration

public int FadeAnimationFrames { get; set; }

Property Value

Gets or sets the time interval for each fade animation frame.

Declaration

public int FadeAnimationSpeed { get; set; }

Property Value

Gets or sets a value indicating the type of the fade animation.

Declaration

public FadeAnimationType FadeAnimationType { get; set; }

Property Value

Gets or sets a value from the FitToScreenModes enum which defines how the size of the popup is fit to the currently active screen.

Declaration

public FitToScreenModes FitToScreenMode { get; set; }

Property Value

Defines how the popup will be horizontally aligned in case of lack of screen space.

Declaration

public AlignmentCorrectionMode HorizontalAlignmentCorrectionMode { get; set; }

Property Value

Gets or sets a value that defines the horizontal alignment of the popup based on the alignment rectangle passed in the ShowPopup method.

Declaration

public HorizontalPopupAlignment HorizontalPopupAlignment { get; set; }

Property Value

Declaration

public SizeF LastShowDpiScaleFactor { get; set; }

Property Value

Declaration

protected Size NonAnimatedSize { get; }

Property Value

Gets or sets a float value that determines the opacity of the popup. This property accepts values from 0.0 to 1.0. For example, to make the popup semi-transparent, set the property to 0.5.

Declaration

public float Opacity { get; set; }

Property Value

Gets the RadElement that owns this popup.

Declaration

[Browsable(false)]
public RadElement OwnerElement { get; }

Property Value

Implements IPopupControl.OwnerElement

Declaration

[Browsable(false)]
public IPopupControl OwnerPopup { get; }

Property Value

Implements IPopupControl.OwnerPopup

Gets or sets a value from the ScreenSpaceMode enum which determines what part of the screen is considered when positioning the popup.

Declaration

public ScreenSpaceMode ScreenSpaceMode { get; set; }

Property Value

Declaration

protected virtual bool ShouldRestoreAutoSize { get; }

Property Value

Defines how the popup will be vertically aligned in case of lack of screen space.

Declaration

public AlignmentCorrectionMode VerticalAlignmentCorrectionMode { get; set; }

Property Value

Gets or sets a value that defines the vertical alignment of the popup based on the alignment rectangle passed in the ShowPopup method.

Declaration

public VerticalPopupAlignment VerticalPopupAlignment { get; set; }

Property Value

Gets or sets the windows related setting.

Declaration

public WindowsSettings WindowsSettings { get; set; }

Property Value

Fires when a drop-down animation is about to begin.

Declaration

protected virtual void AnimationStarting()

Declaration

protected virtual Size ApplySizingConstraints(Size availableSize, Screen currentScreen)

Parameters

Returns

Raises the MouseWheel event.

Declaration

protected virtual void CallMouseWheel(MouseEventArgs e)

Parameters

This method determines whether the IPopupControl can be closed. Used in the PopupManager class to prevent the IPopupControl from closing in specific occasions.

Declaration

public virtual bool CanClosePopup(RadPopupCloseReason reason)

Parameters

Returns

Implements IPopupControl.CanClosePopup(RadPopupCloseReason)

Checks whether the current alignment rectangle intersects with the popup's bounds according to a given popup location.

Declaration

protected virtual Point CheckMakeLastLocationCorrection(Rectangle alignmentRectangle, Point proposedLocation, Rectangle availableBounds)

Parameters

Returns

Checks whether the current alignment rectangle intersects with the popup's bounds according to a given popup location.

Declaration

protected virtual Point CheckMakeLastLocationCorrection(Rectangle alignmentRectangle, Point proposedLocation, Rectangle availableBounds, Size popupSize)

Parameters

Returns

Closes the popup.

Declaration

public virtual void ClosePopup(PopupCloseInfo info)

Parameters

Implements IPopupControl.ClosePopup(PopupCloseInfo)

Closes the IPopupControl.

Declaration

public virtual void ClosePopup(RadPopupCloseReason reason)

Parameters

Implements IPopupControl.ClosePopup(RadPopupCloseReason)

Declaration

protected override void Dispose(bool disposing)

Parameters

Overrides RadControl.Dispose(bool)

Gets a Rectangle which represents the available bounds for the popup to show. By default this method returns the bounds of the screen.

Declaration

protected virtual Rectangle GetAvailableBoundsFromScreen(Screen screen)

Parameters

Returns

Declaration

protected virtual Size GetBackupSize()

Returns

Calculates the horizontal position of the popup according to the current HorizontalPopupAlignment and AlignmentCorrectionMode.

Declaration

protected virtual Point GetCorrectedHorizontalLocation(Screen currentScreen, Rectangle alignmentRectangle, Point calculatedLocation)

Parameters

Returns

Calculates the horizontal position of the popup according to the current HorizontalPopupAlignment and AlignmentCorrectionMode.

Declaration

protected virtual Point GetCorrectedHorizontalLocation(Screen currentScreen, Rectangle alignmentRectangle, Point calculatedLocation, Size popupSize)

Parameters

Returns

This method returns a point which defines the position of the popup. By default, aligns the popup based on the alignmentRectangle and the current alignment settings. You can adjust the alignment settings by settin the HorizontalPopupAlignment and VerticalPopupAlignment properties.

Declaration

protected virtual Point GetCorrectedLocation(Rectangle alignmentRectangle)

Parameters

Returns

This method returns a point which defines the position of the popup. By default, aligns the popup based on the alignmentRectangle and the current alignment settings. You can adjust the alignment settings by settin the HorizontalPopupAlignment and VerticalPopupAlignment properties.

Declaration

protected virtual Point GetCorrectedLocation(Screen currentScreen, Rectangle alignmentRectangle)

Parameters

Returns

This method returns a point which defines the position of the popup. By default, aligns the popup based on the alignmentRectangle and the current alignment settings. You can adjust the alignment settings by settin the HorizontalPopupAlignment and VerticalPopupAlignment properties.

Declaration

protected virtual Point GetCorrectedLocation(Screen currentScreen, Rectangle alignmentRectangle, Size popupSize)

Parameters

Returns

Calculates the vertical position of the popup according to the current VerticalPopupAlignment and AlignmentCorrectionMode.

Declaration

protected virtual Point GetCorrectedVerticalLocation(Screen currentScreen, Rectangle alignmentRectangle, Point calculatedLocation)

Parameters

Returns

Calculates the vertical position of the popup according to the current VerticalPopupAlignment and AlignmentCorrectionMode.

Declaration

protected virtual Point GetCorrectedVerticalLocation(Screen currentScreen, Rectangle alignmentRectangle, Point calculatedLocation, Size popupSize)

Parameters

Returns

Gets an instance of the Screen class that represents the screen where the popup is displayed.

Declaration

public Screen GetCurrentScreen()

Returns

Gets the screen on which the popup will be displayed.

Declaration

protected virtual Screen GetCurrentScreen(Rectangle alignmentRectangle)

Parameters

Returns

Calculates the horizontal popup location based on the alignmentRectangle. This method uses the HorizontalPopupAlignment property setting.

Declaration

protected virtual int GetHorizontalPopupLocation(Rectangle alignmentRectangle)

Parameters

Returns

Override the base DPI scaling behavior to prevent location calculation bugs in multi-monitor setups.

Problem: When displaying a popup on a secondary monitor with different DPI scaling than the primary monitor (e.g., Primary: 125%, Secondary: 100%), the popup's location is calculated incorrectly on first show.

Root Cause: The popup content is measured and arranged before being shown to determine the correct location. However, if the popup has never been displayed, it uses the primary monitor's DPI settings for measurement. After the first show, the DPI is correctly adjusted, but the initial measurements were wrong, causing incorrect popup positioning.

Solution: Use the owner element's DPI scale factor instead of the base implementation to ensure consistent DPI scaling from the start.

Declaration

protected override SizeF GetMonitorDpiScaleFactor(Control control)

Parameters

Returns

Overrides RadControl.GetMonitorDpiScaleFactor(Control)

Calculates the vertical popup location based on the alignmentRectangle. This method uses the VerticalPopupAlignment property setting.

Declaration

protected virtual int GetVerticalPopupLocation(Rectangle alignmentRectangle)

Parameters

Returns

Closes the popup.

Declaration

public void Hide()

Declaration

protected virtual void InitializeDropDownAnimation(Point location)

Parameters

This method is executed when the popup needs to receive manual horizontal alignment. This can happen when there is no reasonable possibility for the alignment routines to define a proper horizontal position for the popup. In this way the developer is enabled to define a horizontal position according to their preferences.

Declaration

protected virtual Point OnAlternativeXLocationNeeded(Rectangle alignmentRectangle, Point proposedLocation, Rectangle availableBounds)

Parameters

Returns

This method is executed when the popup needs to receive manual vertical alignment. This can happen when there is no reasonable possibility for the alignment routines to define a proper vertical position for the popup. In this way the developer is enabled to define a vertical position according to their preferences.

Declaration

protected virtual Point OnAlternativeYLocationNeeded(Rectangle alignmentRectangle, Point proposedLocation, Rectangle availableBounds)

Parameters

Returns

Declaration

protected virtual void OnAnimating(AnimationEventArgs e)

Parameters

Declaration

protected virtual void OnAnimationFinished(AnimationEventArgs args)

Parameters

Executes when a key is pressed.

Declaration

public virtual bool OnKeyDown(Keys keyData)

Parameters

Returns

Implements IPopupControl.OnKeyDown(Keys)

Determines whether the MouseWheel event is handled by the popup.

Declaration

public virtual bool OnMouseWheel(Control target, int delta)

Parameters

Returns

Implements IPopupControl.OnMouseWheel(Control, int)

Called when popup is closed.

Declaration

protected virtual void OnPopupClosed(PopupCloseInfo info)

Parameters

Fires when the popup is closed.

Declaration

protected virtual void OnPopupClosed(RadPopupClosedEventArgs args)

Parameters

Called when the popup is closing.

Declaration

protected virtual bool OnPopupClosing(PopupCloseInfo info)

Parameters

Returns

Fires when the popup is about to close.

Declaration

protected virtual void OnPopupClosing(RadPopupClosingEventArgs args)

Parameters

Fires when the popup is opened.

Declaration

protected virtual void OnPopupOpened()

Fires when the popup is about to open.

Declaration

protected virtual void OnPopupOpening(CancelEventArgs args)

Parameters

Processes a focus request from the specified element.

Declaration

protected override bool ProcessFocusRequested(RadElement element)

Parameters

Returns

Overrides RadControl.ProcessFocusRequested(RadElement)

Shows the popup based on the value set to its Location property.

Declaration

public void Show()

Shows the control based on the screen rectangle of a given control.

Declaration

public void Show(Control control)

Parameters

Shows the popup at the location passed as a parameter. The location is in screen coordinates

Declaration

public void Show(Point screenLocation)

Parameters

Shows the popup.

Declaration

public virtual void ShowPopup(Rectangle alignmentRectangle)

Parameters

Implements IPopupControl.ShowPopup(Rectangle)

Declaration

protected virtual void ShowPopupCore(Size size, Point location)

Parameters

Updates the Aero effects support upon property change.

Declaration

protected void UpdateAeroEffectState()

Updates the location of the popup based on the last used alignment rectangle and the current alignment settings. You can adjust the alignment settings by using the VerticalPopupAlignment and HorizontalPopupAlignment properties.

Declaration

public void UpdateLocation()

Updates the location of the popup based on the alignment rectangle and the current alignment settings. You can adjust the alignment settings by using the VerticalPopupAlignment and HorizontalPopupAlignment properties.

Declaration

public void UpdateLocation(Rectangle alignmentRectangle)

Parameters

Declaration

protected override void WndProc(ref Message m)

Parameters

Overrides RadControl.WndProc(ref Message)

Fires when a fade animation has finished. The event args contain information about the type of the animation.

Declaration

public event RadPopupFadeAnimationFinishedEventHandler FadeAnimationFinished

Event Value

Occurs when the mouse pointer is moved over the element.

Declaration

[Browsable(false)]
public event MouseEventHandler MouseWheel

Event Value

Fires when the popup is closed.

Declaration

public event RadPopupClosedEventHandler PopupClosed

Event Value

Fires when the popup is about to be closed.

Declaration

public event RadPopupClosingEventHandler PopupClosing

Event Value

Fires when the popup-form is opened.

Declaration

public event RadPopupOpenedEventHandler PopupOpened

Event Value

Fires when the popup-form is about to be opened.

Declaration

public event RadPopupOpeningEventHandler PopupOpening

Event Value