New to Telerik UI for WinFormsStart a free 30-day trial

Represents a popup editor control that provides a text editor with an associated popup container for hosting custom content.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
[TelerikToolboxCategory("Editors")]
public class RadPopupEditor : RadEditorControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadEditorControlRadPopupEditor...

Derived Classes: RadFontDropDownList

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISynchronizeInvokeIWin32Window...

Inherited Members RadEditorControl.OnParentChanged(EventArgs)RadEditorControl.GetPreferredSize(Size)RadEditorControl.GetRootElementDesiredSize(int, int, int, int)RadEditorControl.SetBoundsCore(int, int, int, int, BoundsSpecified)RadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Construct()RadControl.CreateBehavior()RadControl.CreateRootElement()RadControl.InitializeRootElement(RootRadElement)RadControl.LoadElementTree()RadControl.LoadElementTree(Size)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.OnCreateControl()RadControl.OnHandleDestroyed(EventArgs)RadControl.OnFontChanged(EventArgs)RadControl.OnForeColorChanged(EventArgs)RadControl.OnBackColorChanged(EventArgs)RadControl.OnEnabledChanged(EventArgs)RadControl.OnLocationChanged(EventArgs)RadControl.OnPaddingChanged(EventArgs)RadControl.OnRightToLeftChanged(EventArgs)RadControl.OnPaint(PaintEventArgs)RadControl.OnLayout(LayoutEventArgs)RadControl.OnAutoSizeChanged(EventArgs)RadControl.WndProc(ref Message)RadControl.OnInvalidated(RadElement)RadControl.OnCaptureLosing()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)RadControl.ProcessMnemonic(char)RadControl.ProcessFocusRequested(RadElement)RadControl.ProcessCaptureChangeRequested(RadElement, bool)RadControl.IsInputKey(Keys)RadControl.GetInputElement()RadControl.BeginInit()RadControl.EndInit()RadControl.OnNotifyPropertyChanged(string)RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)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.EnableThemingRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.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

Initializes a new instance of the RadPopupEditor class.

C#
public RadPopupEditor()

Properties

Gets or sets the associated popup container control.

C#
public virtual RadPopupContainer AssociatedControl { get; set; }

Gets or sets whether the edit control is auto-sized

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

Overrides: RadControl.AutoSize

Gets the default size for the popup editor control.

C#
protected override Size DefaultSize { get; }

Overrides: Control.DefaultSize

Gets or sets the drop down maximal size.

C#
public Size DropDownMaxSize { get; set; }

Gets or sets the drop down minimal size.

C#
[Browsable(true)]
public Size DropDownMinSize { get; set; }

Gets or sets a value of the SizingMode enumeration. This value determines how the pop-up form can be resized: vertically, horizontally or both.

C#
[Browsable(true)]
public SizingMode DropDownSizingMode { get; set; }

Gets or sets a value specifying the style of the DropDownList

C#
public virtual RadDropDownStyle DropDownStyle { get; set; }

Gets the RadDropDownListEditableAreaElement that represents the editable area.

C#
[Browsable(false)]
public RadDropDownListEditableAreaElement EditableAreaElement { get; }
C#
[Browsable(false)]
public RadPopupControlBase Popup { get; }

Gets the RadPopupEditorElement that represents the element hierarchy.

C#
[Browsable(false)]
public RadPopupEditorElement PopupEditorElement { get; set; }

Gets the popup form that contains the associated control.

C#
[Browsable(false)]
public RadPopupControlBase PopupForm { get; }

Gets or sets the TextBox visibility.

C#
public virtual bool ShowTextBox { get; set; }

Gets or sets a value indicating whether the user can give the focus to this control using the TAB key.

C#
[Browsable(false)]
public bool TabStop { get; set; }
Property Value:

true if the user can give the focus to the control using the TAB key;otherwise, false. The default is true.

C#
[Browsable(true)]
[Bindable(true)]
[SettingsBindable(true)]
public override string Text { get; set; }

Overrides: RadControl.Text

Represents the TextBox that is hosted inside.

C#
[Browsable(false)]
public virtual RadTextBoxElement TextBoxElement { get; }

Gets or sets the theme class name for this control.

C#
public override string ThemeClassName { get; }

Overrides: RadControl.ThemeClassName

Methods

Creates the child items for the popup editor control.

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

The parent element to add the child items to.

Overrides: RadControl.CreateChildItems(RadElement)

Creates the popup editor element for this control.

C#
protected virtual RadPopupEditorElement CreateElement()
Returns:

RadPopupEditorElement

A new instance of RadPopupEditorElement.

Releases the unmanaged resources used by the RadPopupEditor and optionally releases the managed resources.

C#
protected override void Dispose(bool disposing)
Parameters:disposingbool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Overrides: RadControl.Dispose(bool)

Called when the binding context changes and updates the popup form's binding context accordingly.

C#
protected override void OnBindingContextChanged(EventArgs e)
Parameters:eEventArgs

The EventArgs that contains the event data.

Overrides: RadControl.OnBindingContextChanged(EventArgs)

Called when the control gains focus and triggers invalidation for visual updates.

C#
protected override void OnGotFocus(EventArgs e)
Parameters:eEventArgs

The EventArgs that contains the event data.

Overrides: RadControl.OnGotFocus(EventArgs)

Called when the control is loaded with the specified desired size.

C#
protected override void OnLoad(Size desiredSize)
Parameters:desiredSizeSize

The desired size for the control.

Overrides: RadControl.OnLoad(Size)

Called when the control loses focus and triggers invalidation for visual updates.

C#
protected override void OnLostFocus(EventArgs e)
Parameters:eEventArgs

The EventArgs that contains the event data.

Overrides: RadControl.OnLostFocus(EventArgs)

Called when the theme is changed and applies the theme to the popup form.

C#
protected override void OnThemeChanged()

Overrides: RadControl.OnThemeChanged()

Called when the control's visibility changes and updates the associated control's visibility accordingly.

C#
protected override void OnVisibleChanged(EventArgs e)
Parameters:eEventArgs

The EventArgs that contains the event data.

Overrides: RadControl.OnVisibleChanged(EventArgs)

Processes auto-size changes by adjusting the stretch behavior of the root element.

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

true if auto-size is enabled; otherwise, false.

Overrides: RadControl.ProcessAutoSizeChanged(bool)

Processes command keys and handles popup closing for certain key combinations.

C#
protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
Parameters:msgMessage

The window message to process.

keyDataKeys

The key data associated with the message.

Returns:

bool

true if the command key was processed; otherwise, false.

Overrides: Control.ProcessCmdKey(ref Message, Keys)

Resets the background color theme overrides for the popup editor elements.

C#
protected override void ResetBackColorThemeOverrides()

Overrides: RadControl.ResetBackColorThemeOverrides()

Resets the foreground color theme overrides for the popup editor elements.

C#
protected override void ResetForeColorThemeOverrides()

Overrides: RadControl.ResetForeColorThemeOverrides()

Sets the associated control at runtime for the popup editor.

C#
public virtual void SetAssociatedControlRuntime(RadPopupContainer associatedControl)
Parameters:associatedControlRadPopupContainer

The RadPopupContainer to associate with this editor.

Sets the background color theme overrides for the popup editor elements.

C#
protected override void SetBackColorThemeOverrides()

Overrides: RadControl.SetBackColorThemeOverrides()

Sets the foreground color theme overrides for the popup editor elements.

C#
protected override void SetForeColorThemeOverrides()

Overrides: RadControl.SetForeColorThemeOverrides()

Unwires the host events for the popup editor control.

C#
protected virtual void UnwireHostEvents()

Wires the host events for the popup editor control.

C#
protected virtual void WireHostEvents()

Events

Occurs when the popup is closed.

C#
public event RadPopupClosedEventHandler PopupClosed

Occurs when the popup is closing.

C#
public event RadPopupClosingEventHandler PopupClosing

Occurs when the popup is opened.

C#
public event EventHandler PopupOpened

Occurs before the popup is opened. This event can be cancelled.

C#
public event CancelEventHandler PopupOpening