Click or drag to resize
RadPopupControlBase Class
Represents a base class for all popup-forms used throughout the suite.
Inheritance Hierarchy
SystemObject
  SystemMarshalByRefObject
    System.ComponentModelComponent
      System.Windows.FormsControl
        System.Windows.FormsScrollableControl
          Telerik.WinControlsRadControl
            Telerik.WinControls.UIRadPopupControlBase
              Telerik.WinControls.UIDesktopAlertPopup
              Telerik.WinControls.UI.MenuRadMenuItemPopup
              Telerik.WinControls.UIRadItemsPopupControl
              Telerik.WinControls.UIRadSizablePopupControl
              Telerik.WinControls.UI.RibbonBarRibbonBarPopup

Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI (in Telerik.WinControls.UI.dll) Version: 2018.1.220.40 (2018.1.220.40)
Syntax
public class RadPopupControlBase : RadControl, 
	IPopupControl

The RadPopupControlBase type exposes the following members.

Constructors
  NameDescription
Public methodRadPopupControlBase
Creates an instance of the RadPopupFormBase class.
Top
Properties
  NameDescription
Public propertyAccessibilityRequested
Gets or sets a value indicating whether the CodedUI Tests functionality is requested from external program such a Narrator.
(Inherited from RadControl.)
Public propertyAlignmentRectangleOverlapMode
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.
Public propertyAllowShowFocusCues
Indicates focus cues display, when available, based on the corresponding control type and the current UI state.
(Inherited from RadControl.)
Public propertyAnalyticsName
Gets or sets the Analytics Name associated with this control. By default the Control Name property is logged. If you want to customize the information which will be logged for this control set this property to a preferred value.
(Inherited from RadControl.)
Public propertyAnimationEnabled
Gets or sets a bool value determining whether popup animation is enabled.
Public propertyAnimationFrames
Gets or sets the count of the frames of the drop down animation.
Public propertyAnimationType
Gets or sets a value determining what animation type to use when showing the popup.
Public propertyAutoSize

Gets or sets a value indicating whether the control is automatically resized to display its entire contents.

(Inherited from RadControl.)
Public propertyBackColor
Gets or sets the BackColor of the control. This is actually the BackColor property of the root element.
(Inherited from RadControl.)
Public propertyBehavior
Gets the input behavior for the control.
(Inherited from RadControl.)
Public propertyCausesValidation
Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.
(Inherited from RadControl.)
Public propertyChildren
Gets a ListT instance that represents a collection of logical children of this IPopupControl. The OwnerPopup property of these children would point to this IPopupControl instance.
Public propertyCommandBindings (Inherited from RadControl.)
Protected propertyCreateParams (Overrides ScrollableControlCreateParams.)
Public propertyDropDownAnimationDirection
Gets or sets the direction of the drop-down animation.
Public propertyDropShadow
Gets or sets a boolean value which determines whether the popup drops a shadow.
Public propertyEasingType
Gets or sets the easing type for the drop down animations.
Public propertyElementTree (Inherited from RadControl.)
Public propertyEnableAeroEffects
Enables the support for Windows Vista DWM effects.
Public propertyEnableAnalytics
Gets or sets a value indicating whether the Analytics functionality is enabled or disabled for this control.
(Inherited from RadControl.)
Public propertyEnableCodedUITests
Gets or sets a value indicating whether the CodedUI Tests functionality is enabled.
(Inherited from RadControl.)
Public propertyEnableGestures
Gets or sets a value indicating whether the Gestures functionality is enabled.
(Inherited from RadControl.)
Public propertyEnableKeyMap
Gets or sets whether Key Map (Office 2007 like accelerator keys map) is used for this specific control. Currently this option is implemented for the RadRibbonBar control only.
(Inherited from RadControl.)
Public propertyEnableRadAccessibilityObjects
Gets or sets a value indicating whether the RadControls Accessible custom object is enabled.
(Inherited from RadControl.)
Public propertyEnableTheming
Gets or sets value indicating whether the control is styled through theme
(Inherited from RadControl.)
Public propertyFadeAnimationFrames
Gets or sets the frame count for the fade animation.
Public propertyFadeAnimationSpeed
Gets or sets the time interval for each fade animation frame.
Public propertyFadeAnimationType
Gets or sets a value indicating the type of the fade animation.
Public propertyFitToScreenMode
Gets or sets a value from the FitToScreenModes enum which defines how the size of the popup is fit to the currently active screen.
Public propertyFocusable (Inherited from RadControl.)
Public propertyFocusedElement (Inherited from RadControl.)
Public propertyFont
Gets or sets the Font of the control. This is actually the Font property of the root element.
(Inherited from RadControl.)
Public propertyForeColor
Gets or sets the ForeColor of the control. This is actually the ForeColor property of the root element.
(Inherited from RadControl.)
Public propertyHorizontalAlignmentCorrectionMode
Defines how the popup will be horizontally aligned in case of lack of screen space.
Public propertyHorizontalPopupAlignment
Gets or sets a value that defines the horizontal alignment of the popup based on the alignment rectangle passed in the ShowPopup method.
Public propertyImageList
Gets or sets the ImageList that contains the images displayed by this control.
(Inherited from RadControl.)
Public propertyImageScalingSize
Gets or sets the image scaling size.
(Inherited from RadControl.)
Public propertyIsDesignMode (Inherited from RadControl.)
Public propertyIsDisplayed
Determines whether the control is currently displayed on the screen.
(Inherited from RadControl.)
Public propertyIsInitializing (Inherited from RadControl.)
Public propertyIsLoaded
Determines whether the control is properly loaded.
(Inherited from RadControl.)
Public propertyLastShowDpiScaleFactor
Public propertyLayoutManager (Inherited from RadControl.)
Public propertyMaximumSize
Gets or sets the size that is the upper limit that GetPreferredSize can specify.
(Inherited from RadControl.)
Public propertyMinimumSize
Gets or sets the size that is the lower limit that GetPreferredSize can specify
(Inherited from RadControl.)
Protected propertyNonAnimatedSize
Public propertyOpacity
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.
Public propertyOwnerElement
Gets the RadElement that owns this popup.
Public propertyOwnerPopup
Public propertyPadding
Gets or sets padding within the control.
(Inherited from RadControl.)
Public propertyRootElement
Gets the RootElement of the control.
(Inherited from RadControl.)
Public propertyScreenSpaceMode
Gets or sets a value from the ScreenSpaceMode enum which determines what part of the screen is considered when positioning the popup.
Protected propertyShouldRestoreAutoSize
Public propertyShowItemToolTips
Gets or sets a value indicating whether ToolTips are shown for the RadItem objects contained in the RadControl.
(Inherited from RadControl.)
Public propertySite (Inherited from RadControl.)
Public propertySmallImageList
Gets or sets the SmallImageList that contains the small images which are displayed when there's not enough space.
(Inherited from RadControl.)
Public propertySmallImageScalingSize
Gets or sets the small image scaling size.
(Inherited from RadControl.)
Public propertyText (Inherited from RadControl.)
Public propertyThemeClassName
Gets or sets the class name string that ThemeResolutionService will use to find the themes registered for the control.
(Inherited from RadControl.)
Public propertyThemeName
Gets or sets control's preferred theme name. Themes are stored and retrieved using APIs of ThemeResolutionService.
(Inherited from RadControl.)
Public propertyUseCompatibleTextRendering
Determines whether to use compatible text rendering engine (GDI+) or not (GDI).
(Inherited from RadControl.)
Protected propertyValidationCancel (Inherited from RadControl.)
Public propertyVerticalAlignmentCorrectionMode
Defines how the popup will be vertically aligned in case of lack of screen space.
Public propertyVerticalPopupAlignment
Gets or sets a value that defines the vertical alignment of the popup based on the alignment rectangle passed in the ShowPopup method.
Top
Methods
  NameDescription
Protected methodAnimationStarting
Fires when a drop-down animation is about to begin.
Protected methodApplySizingConstraints
Public methodBeginInit
Suspends layout during initialization.
(Inherited from RadControl.)
Public methodCallAccessibilityNotifyClients
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnGotFocus
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnKeyDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnKeyPress
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnKeyUp
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnLostFocus
This method is used internally!
(Inherited from RadControl.)
Protected methodCallMouseWheel
Raises the MouseWheel event.
Public methodCallOnClick
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnDoubleClick
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnKeyDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnKeyPress
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnKeyUp
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseCaptureChanged
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseEnter
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseHover
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseLeave
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseMove
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseUp
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseWheel
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnPreviewKeyDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnScreenTipNeeded
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnThemeNameChanged
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnToolTipTextNeeded
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnVisibleChanged
This method is used internally!
(Inherited from RadControl.)
Public methodCanClosePopup
This method determines whether the IPopupControl can be closed. Used in the PopupManager class to prevent the IPopupControl from closing in specific occasions.
Protected methodCanEditElementAtDesignTime
Determines whether an element may be edited via the EditUIElements dialog at design-time.
(Inherited from RadControl.)
Public methodCanEditUIElement
Determines whether an element from this element tree may be displayed in the EditUIElements dialog.
(Inherited from RadControl.)
Protected methodCheckMakeLastLocationCorrection
Checks whether the current alignment rectangle intersects with the popup's bounds according to a given popup location.
Public methodClosePopup(PopupCloseInfo)
Closes the popup.
Public methodClosePopup(RadPopupCloseReason)
Closes the IPopupControl.
Protected methodConstruct (Inherited from RadControl.)
Public methodControlDefinesThemeForElement
Checks whether the element's theme is defined by the control.
(Inherited from RadControl.)
Protected methodCreateBehavior
Creates the input behavior instance. Allows inheritors to provide custom input implementations.
(Inherited from RadControl.)
Protected methodCreateChildItems (Inherited from RadControl.)
Protected methodCreateRootElement (Inherited from RadControl.)
Public methodDisableGesture
Disable firing gesture events of the specified type.
(Inherited from RadControl.)
Protected methodDispose
Releases the unmanaged resources used by the RadPopupControlBase and optionally releases the managed resources
(Overrides RadControlDispose(Boolean).)
Public methodEnableGesture
Enable firing gesture events of the specified type.
(Inherited from RadControl.)
Public methodEndInit
Resumes layout.
(Inherited from RadControl.)
Protected methodFindPropertyInChildren (Inherited from RadControl.)
Protected methodGetAvailableBoundsFromScreen
Gets a Rectangle which represents the available bounds for the popup to show. By default this method returns the bounds of the screen.
Protected methodGetBackupSize
Public methodGetChildAt
Method used by control Code Dom serializer to access element in the collection of RootElement.
(Inherited from RadControl.)
Public methodGetControlDefaultSize
This method is used internally!
(Inherited from RadControl.)
Protected methodGetCorrectedHorizontalLocation
Calculates the horizontal position of the popup according to the current HorizontalPopupAlignment and AlignmentCorrectionMode.
Protected methodGetCorrectedLocation(Rectangle)
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.
Protected methodGetCorrectedLocation(Screen, Rectangle)
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.
Protected methodGetCorrectedVerticalLocation
Calculates the vertical position of the popup according to the current VerticalPopupAlignment and AlignmentCorrectionMode.
Public methodGetCurrentScreen
Gets an instance of the Screen class that represents the screen where the popup is displayed.
Protected methodGetCurrentScreen(Rectangle)
Gets the screen on which the popup will be displayed.
Protected methodGetHorizontalPopupLocation
Calculates the horizontal popup location based on the alignmentRectangle. This method uses the HorizontalPopupAlignment property setting.
Protected methodGetInputElement (Inherited from RadControl.)
Public methodGetPlainText
Strips all html tags of the text set to the control and returns only the plain text.
(Inherited from RadControl.)
Public methodGetPreferredSize (Inherited from RadControl.)
Protected methodGetRootElementDesiredSize (Inherited from RadControl.)
Protected methodGetVerticalPopupLocation
Calculates the vertical popup location based on the alignmentRectangle. This method uses the VerticalPopupAlignment property setting.
Public methodHide
Closes the popup.
Protected methodInitializeDropDownAnimation
Protected methodInitializeRootElement (Inherited from RadControl.)
Public methodInvokeLayoutCallback (Inherited from RadControl.)
Protected methodIsInputKey (Inherited from RadControl.)
Public methodLoadElementTree
Loads the element tree. While not loaded, no layout operations are allowed upon the tree. By default, the tree will be loaded when the control is displayed for the first time.
(Inherited from RadControl.)
Public methodLoadElementTree(Size)
Loads the element tree using the specified desired size.
(Inherited from RadControl.)
Protected methodOnAlternativeXLocationNeeded
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.
Protected methodOnAlternativeYLocationNeeded
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.
Protected methodOnAnimating
Protected methodOnAnimationFinished
Protected methodOnAutoSizeChanged (Inherited from RadControl.)
Protected methodOnBackColorChanged (Inherited from RadControl.)
Protected methodOnBindingContextChanged (Inherited from RadControl.)
Protected methodOnCaptureLosing (Inherited from RadControl.)
Protected methodOnClick (Inherited from RadControl.)
Protected methodOnCreateControl (Inherited from RadControl.)
Protected methodOnDoubleClick (Inherited from RadControl.)
Protected methodOnEnabledChanged (Inherited from RadControl.)
Protected methodOnFontChanged (Inherited from RadControl.)
Protected methodOnForeColorChanged (Inherited from RadControl.)
Protected methodOnGesture (Inherited from RadControl.)
Protected methodOnGotFocus (Inherited from RadControl.)
Protected methodOnHandleDestroyed (Inherited from RadControl.)
Protected methodOnInvalidated (Inherited from RadControl.)
Protected methodOnKeyDown(KeyEventArgs) (Inherited from RadControl.)
Public methodOnKeyDown(Keys)
Executes when a key is pressed.
Protected methodOnKeyPress (Inherited from RadControl.)
Protected methodOnKeyUp (Inherited from RadControl.)
Protected methodOnLayout (Inherited from RadControl.)
Protected methodOnLoad
Notifies that the control is about to be visualized.
(Inherited from RadControl.)
Protected methodOnLocationChanged (Inherited from RadControl.)
Protected methodOnLostFocus (Inherited from RadControl.)
Protected methodOnMouseCaptureChanged (Inherited from RadControl.)
Protected methodOnMouseDown (Inherited from RadControl.)
Protected methodOnMouseEnter (Inherited from RadControl.)
Protected methodOnMouseHover (Inherited from RadControl.)
Protected methodOnMouseLeave (Inherited from RadControl.)
Protected methodOnMouseMove (Inherited from RadControl.)
Protected methodOnMouseUp (Inherited from RadControl.)
Protected methodOnMouseWheel(MouseEventArgs) (Inherited from RadControl.)
Public methodOnMouseWheel(Control, Int32)
Determines whether the MouseWheel event is handled by the popup.
Protected methodOnNotifyPropertyChanged(PropertyChangedEventArgs) (Inherited from RadControl.)
Protected methodOnNotifyPropertyChanged(String)
Raises the PropertyChanged event
(Inherited from RadControl.)
Protected methodOnPaddingChanged (Inherited from RadControl.)
Protected methodOnPaint (Inherited from RadControl.)
Protected methodOnPanGesture
Fires the PanGesture event.
(Inherited from RadControl.)
Protected methodOnParentChanged (Inherited from RadControl.)
Protected methodOnPopupClosed(PopupCloseInfo)
Called when popup is closed.
Protected methodOnPopupClosed(RadPopupClosedEventArgs)
Fires when the popup is closed.
Protected methodOnPopupClosing(PopupCloseInfo)
Called when the popup is closing.
Protected methodOnPopupClosing(RadPopupClosingEventArgs)
Fires when the popup is about to close.
Protected methodOnPopupOpened
Fires when the popup is opened.
Protected methodOnPopupOpening
Fires when the popup is about to open.
Protected methodOnPressAndTapGesture
Fires the PressAndTapGesture event.
(Inherited from RadControl.)
Protected methodOnPreviewKeyDown (Inherited from RadControl.)
Protected methodOnRightToLeftChanged (Inherited from RadControl.)
Protected methodOnRotateGesture
Fires the RotateGesture event.
(Inherited from RadControl.)
Protected methodOnScreenTipNeeded (Inherited from RadControl.)
Protected methodOnThemeChanged (Inherited from RadControl.)
Protected methodOnThemeNameChanged (Inherited from RadControl.)
Protected methodOnToolTipTextNeeded (Inherited from RadControl.)
Protected methodOnTwoFingerTapGesture
Fires the TwoFingerTapGesture event.
(Inherited from RadControl.)
Protected methodOnZoomGesture
Fires the ZoomGesture event.
(Inherited from RadControl.)
Protected methodProcessAutoSizeChanged (Inherited from RadControl.)
Protected methodProcessCaptureChangeRequested
Processes a capture request from the specified element.
(Inherited from RadControl.)
Protected methodProcessCodedUIMessage (Inherited from RadControl.)
Protected methodProcessFocusRequested (Overrides RadControlProcessFocusRequested(RadElement).)
Protected methodProcessGesture (Inherited from RadControl.)
Protected methodProcessMnemonic (Inherited from RadControl.)
Public methodRefresh (Inherited from RadControl.)
Public methodRegisterHostedControl (Inherited from RadControl.)
Protected methodResetBackColorThemeOverrides (Inherited from RadControl.)
Protected methodResetForeColorThemeOverrides (Inherited from RadControl.)
Public methodResolveStyleGroupForElement
Replaces the default style group for specific element.
(Inherited from RadControl.)
Public methodResumeUpdate (Inherited from RadControl.)
Public methodResumeUpdate(Boolean) (Inherited from RadControl.)
Protected methodScaleControl (Inherited from RadControl.)
Protected methodSetBackColorThemeOverrides (Inherited from RadControl.)
Protected methodSetBoundsCore (Inherited from RadControl.)
Protected methodSetForeColorThemeOverrides (Inherited from RadControl.)
Public methodSetIsInitializing
This method is used internally!
(Inherited from RadControl.)
Public methodShouldSerializeBackColor
Determines whether the BackColor property should be serialized.
(Inherited from RadControl.)
Public methodShouldSerializeFont
Determines whether the ForeColor property should be serialized.
(Inherited from RadControl.)
Public methodShouldSerializeForeColor
Determines whether the ForeColor property should be serialized.
(Inherited from RadControl.)
Protected methodShouldSerializeProperty
Determines whether the specified RadProperty should be serialized.
(Inherited from RadControl.)
Public methodShow
Shows the popup based on the value set to its Location property.
Public methodShow(Point)
Shows the popup at the location passed as a parameter. The location is in screen coordinates
Public methodShow(Control)
Shows the control based on the screen rectangle of a given control.
Public methodShowPopup
Shows the popup.
Protected methodShowPopupCore
Public methodSuspendUpdate (Inherited from RadControl.)
Public methodUnregisterHostedControl (Inherited from RadControl.)
Protected methodUpdateAeroEffectState
Updates the Aero effects support upon property change.
Public methodUpdateLocation
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.
Public methodUpdateLocation(Rectangle)
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.
Protected methodWndProc (Overrides RadControlWndProc(Message).)
Top
Events
  NameDescription
Public eventElementInvalidated (Inherited from RadControl.)
Public eventFadeAnimationFinished
Fires when a fade animation has finished. The event args contain information about the type of the animation.
Public eventInitialized
Fires when the control is initialized.
(Inherited from RadControl.)
Public eventMouseWheel
Occurs when the mouse pointer is moved over the element.
Public eventPanGesture
Occurs when a pan gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventPopupClosed
Fires when the popup is closed.
Public eventPopupClosing
Fires when the popup is about to be closed.
Public eventPopupOpened
Fires when the popup-form is opened.
Public eventPopupOpening
Fires when the popup-form is about to be opened.
Public eventPressAndTapGesture
Occurs when a press-and-tap gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventPropertyChanged
Occurs when a property of an object changes change. Calling the event is developer's responsibility.
(Inherited from RadControl.)
Public eventRotateGesture
Occurs when a rotate gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventScreenTipNeeded
Occurs prior the ScreenTip of a RadItem instance inside the RadControl is displayed.
(Inherited from RadControl.)
Public eventThemeNameChanged
Fires when the theme name is changed.
(Inherited from RadControl.)
Public eventToolTipTextNeeded
Occurs when a RadItem instance inside the RadControl requires ToolTip text.
(Inherited from RadControl.)
Public eventTwoFingerTapGesture
Occurs when a two-finger-tap gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventZoomGesture
Occurs when a zoom gesture was sent by a touch input device.
(Inherited from RadControl.)
Top
Fields
See Also