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

Represents a simple dialog that provides customization options for the RadCommandBar element.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class CommandBarCustomizeDialog : RadForm, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, IComponentTreeHandler, ILayoutHandler, ISupportInitializeNotification, ISupportInitialize, INotifyPropertyChanged, IAnalyticsProvider, ISupportRootUIAutomation

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlFormRadFormControlBaseRadFormCommandBarCustomizeDialog...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIContainerControlIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISupportRootUIAutomationISynchronizeInvokeIWin32Window...

Inherited Members RadForm.ScrollToControl(Control)RadForm.EndInit()RadForm.WndProc(ref Message)RadForm.ProcessCaptureChangeRequested(RadElement, bool)RadForm.InitializeFormBehavior()RadForm.SetIconPrimitiveVisibility(bool)RadForm.EnableUIAutomationRadForm.TextRadForm.ThemeClassNameRadForm.FormElementRadForm.IconScalingRadForm.AllowThemingRadForm.ShowIconRadFormControlBase.newBoundsRadFormControlBase.oldDpiRadFormControlBase.currentDpiRadFormControlBase.isBehaviorPreparedRadFormControlBase.controlIsInitializingRootComponentRadFormControlBase.isPaintingRadFormControlBase.Construct()RadFormControlBase.OnCreateControl()RadFormControlBase.LoadElementTree()RadFormControlBase.LoadElementTree(Size)RadFormControlBase.OnLoad(Size)RadFormControlBase.OnShown(EventArgs)RadFormControlBase.OnPaint(PaintEventArgs)RadFormControlBase.OnPaintBackground(PaintEventArgs)RadFormControlBase.ProcessDialogKey(Keys)RadFormControlBase.UpdateDefaultButton()RadFormControlBase.OnBackColorChanged(EventArgs)RadFormControlBase.OnForeColorChanged(EventArgs)RadFormControlBase.OnFontChanged(EventArgs)RadFormControlBase.OnParentChanged(EventArgs)RadFormControlBase.ShouldSerializeProperty(RadProperty)RadFormControlBase.ResetFormBehavior(bool)RadFormControlBase.PerformDesignModeLocationCorrection(ref Message)RadFormControlBase.CallBaseWndProc(ref Message)RadFormControlBase.ProcessFocusRequested(RadElement)RadFormControlBase.OnNotifyPropertyChanged(string)RadFormControlBase.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadFormControlBase.CreateChildItems(RadElement)RadFormControlBase.CreateRootElement()RadFormControlBase.OnThemeNameChanged(ThemeNameChangedEventArgs)RadFormControlBase.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)RadFormControlBase.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadFormControlBase.OnHandleCreated(EventArgs)RadFormControlBase.OnVisibleChanged(EventArgs)RadFormControlBase.OnAutoSizeChanged(EventArgs)RadFormControlBase.OnLayout(LayoutEventArgs)RadFormControlBase.CreateHandle()RadFormControlBase.SetClientSizeCore(int, int)RadFormControlBase.SetBoundsCore(int, int, int, int, BoundsSpecified)RadFormControlBase.GetPreferredSize(Size)RadFormControlBase.InvalidateIfNotSuspended()RadFormControlBase.InvalidateElement(RadElement)RadFormControlBase.InvalidateElement(RadElement, Rectangle)RadFormControlBase.AddInvalidatedRect(Rectangle)RadFormControlBase.SuspendUpdate()RadFormControlBase.ResumeUpdate()RadFormControlBase.ResumeUpdate(bool)RadFormControlBase.RegisterHostedControl(RadHostItem)RadFormControlBase.UnregisterHostedControl(RadHostItem, bool)RadFormControlBase.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadFormControlBase.ControlThemeChangedCallback()RadFormControlBase.InvokeLayoutCallback(LayoutCallback)RadFormControlBase.BeginInit()RadFormControlBase.HandleDpiChanged()RadFormControlBase.ScaleControl(SizeF, BoundsSpecified)RadFormControlBase.SuspendDpiScaling()RadFormControlBase.ResumeDpiScaling()RadFormControlBase.OnWm_SettingChange(Message)RadFormControlBase.SiteRadFormControlBase.EnableAnalyticsRadFormControlBase.IsLoadedRadFormControlBase.MaximumSizeRadFormControlBase.MinimumSizeRadFormControlBase.FormBorderStyleRadFormControlBase.FormBehaviorRadFormControlBase.BehaviorRadFormControlBase.SmallImageListRadFormControlBase.FocusedElementRadFormControlBase.AllowShowFocusCuesRadFormControlBase.ShowItemToolTipsRadFormControlBase.CommandBindingsRadFormControlBase.EnableKeyMapRadFormControlBase.WindowsSettingsRadFormControlBase.BackColorRadFormControlBase.ForeColorRadFormControlBase.FontRadFormControlBase.CreateParamsRadFormControlBase.IsDesignModeRadFormControlBase.ElementTreeRadFormControlBase.ThemeNameRadFormControlBase.RootElementRadFormControlBase.IsUpdateSuspendedRadFormControlBase.ImageListRadFormControlBase.SmallImageScalingSizeRadFormControlBase.ImageScalingSizeRadFormControlBase.IsInitializedRadFormControlBase.IsPerformingScaleRadFormControlBase.HasOwnToolbarRadFormControlBase.IsDpiScalingSuspendedRadFormControlBase.ThemeNameChangedRadFormControlBase.ToolTipTextNeededRadFormControlBase.ScreenTipNeededRadFormControlBase.InitializedRadFormControlBase.PropertyChangedRadFormControlBase.WindowsThemeChangedForm.SetVisibleCore(bool)Form.Activate()Form.ActivateMdiChild(Form)Form.AddOwnedForm(Form)Form.AdjustFormScrollbars(bool)Form.Close()Form.CreateControlsInstance()Form.DefWndProc(ref Message)Form.ProcessMnemonic(char)Form.CenterToParent()Form.CenterToScreen()Form.LayoutMdi(MdiLayout)Form.OnActivated(EventArgs)Form.OnBackgroundImageChanged(EventArgs)Form.OnBackgroundImageLayoutChanged(EventArgs)Form.OnClosing(CancelEventArgs)Form.OnClosed(EventArgs)Form.OnFormClosing(FormClosingEventArgs)Form.OnFormClosed(FormClosedEventArgs)Form.OnDeactivate(EventArgs)Form.OnEnabledChanged(EventArgs)Form.OnEnter(EventArgs)Form.OnHandleDestroyed(EventArgs)Form.OnHelpButtonClicked(CancelEventArgs)Form.OnMaximizedBoundsChanged(EventArgs)Form.OnMaximumSizeChanged(EventArgs)Form.OnMinimumSizeChanged(EventArgs)Form.OnInputLanguageChanged(InputLanguageChangedEventArgs)Form.OnInputLanguageChanging(InputLanguageChangingEventArgs)Form.OnMdiChildActivate(EventArgs)Form.OnMenuStart(EventArgs)Form.OnMenuComplete(EventArgs)Form.OnResize(EventArgs)Form.OnDpiChanged(DpiChangedEventArgs)Form.OnGetDpiScaledSize(int, int, ref Size)Form.OnRightToLeftLayoutChanged(EventArgs)Form.OnTextChanged(EventArgs)Form.ProcessCmdKey(ref Message, Keys)Form.ProcessDialogChar(char)Form.ProcessKeyPreview(ref Message)Form.ProcessTabKey(bool)Form.RemoveOwnedForm(Form)Form.Select(bool, bool)Form.GetScaledBounds(Rectangle, SizeF, BoundsSpecified)Form.SetDesktopBounds(int, int, int, int)Form.SetDesktopLocation(int, int)Form.Show(IWin32Window)Form.ShowDialog()Form.ShowDialog(IWin32Window)Form.ToString()Form.OnResizeBegin(EventArgs)Form.OnResizeEnd(EventArgs)Form.OnStyleChanged(EventArgs)Form.ValidateChildren()Form.ValidateChildren(ValidationConstraints)Form.AcceptButtonForm.ActiveFormForm.ActiveMdiChildForm.AllowTransparencyForm.AutoScrollForm.AutoSizeForm.AutoSizeModeForm.AutoValidateForm.CancelButtonForm.ClientSizeForm.ControlBoxForm.DefaultImeModeForm.DefaultSizeForm.DesktopBoundsForm.DesktopLocationForm.DialogResultForm.HelpButtonForm.IconForm.IsMdiChildForm.IsMdiContainerForm.IsRestrictedWindowForm.KeyPreviewForm.LocationForm.MaximizedBoundsForm.MainMenuStripForm.MenuForm.MaximizeBoxForm.MdiChildrenForm.MdiParentForm.MergedMenuForm.MinimizeBoxForm.ModalForm.OpacityForm.OwnedFormsForm.OwnerForm.RestoreBoundsForm.RightToLeftLayoutForm.ShowInTaskbarForm.ShowWithoutActivationForm.SizeForm.SizeGripStyleForm.StartPositionForm.TopLevelForm.TopMostForm.TransparencyKeyForm.WindowStateForm.AutoSizeChangedForm.AutoValidateChangedForm.HelpButtonClickedForm.MaximizedBoundsChangedForm.MaximumSizeChangedForm.MinimumSizeChangedForm.ActivatedForm.DeactivateForm.FormClosingForm.FormClosedForm.LoadForm.MdiChildActivateForm.MenuCompleteForm.MenuStartForm.InputLanguageChangedForm.InputLanguageChangingForm.RightToLeftLayoutChangedForm.ShownForm.DpiChangedForm.ResizeBeginForm.ResizeEnd...

Constructors

Creates the dialog controls and initializes their theme context without binding strip data.

C#
public CommandBarCustomizeDialog()

Creates a customize dialog that provides options for the strips in the specified CommandBarStripInfoHolder.

C#
public CommandBarCustomizeDialog(CommandBarStripInfoHolder stripInfoHolder)
Parameters:stripInfoHolderCommandBarStripInfoHolder

The CommandBarStripInfoHolder that supplies the strips and their items.

Fields

Labels the strip selector on the item-customization page.

C#
public RadLabel chooseToolstripLabel

Closes the customization dialog.

C#
public RadButton closeButton

Moves the selected item later in the selected strip's item order.

C#
public RadButton moveDownButton

Moves the selected item earlier in the selected strip's item order.

C#
public RadButton moveUpButton

Hosts the pages for editing strip visibility and strip-item order and visibility.

C#
public RadPageView radPageView

The reset button control, hidden in the dialog's initial layout.

C#
public RadButton resetItemsButton

Supplies the strip data used to populate the customization dialog.

C#
public CommandBarStripInfoHolder stripInfoHolder

Lists the selected strip's items, including items in its overflow panel.

C#
public RadListControl stripItemsListControl

Selects the strip whose items are displayed in the item-customization page.

C#
public RadDropDownList stripsDropDownList

Lists command-bar strips; each row can change whether its strip is shown.

C#
public RadListControl stripsListControl

Displays the selected strip's items and their order and visibility settings.

C#
public RadPageViewPage toolstripItemsPage

Displays the list of command-bar strips and their visibility settings.

C#
public RadPageViewPage toolstripsPage

Methods

Clean up any resources being used.

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

true if managed resources should be disposed; otherwise, false.

Overrides: RadForm.Dispose(bool)

Supplies a data item that exposes a strip's display name and visibility to the list.

C#
protected virtual void ItemDataBinding(object sender, ListItemDataBindingEventArgs args)
Parameters:senderobject

The strips list requesting a data item.

argsListItemDataBindingEventArgs

The binding event data in which to provide the new item.

Moves the selected item later in the combined strip and overflow-panel order.

C#
protected virtual void moveDownButton_Click(object sender, EventArgs e)
Parameters:senderobject

The move-down button.

eEventArgs

Event data for the click.

Moves the selected item earlier in the combined strip and overflow-panel order.

C#
protected virtual void moveUpButton_Click(object sender, EventArgs e)
Parameters:senderobject

The move-up button.

eEventArgs

Event data for the click.

Adjusts the dialog's layout for Metro Touch and Material themes.

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

Event data for the load event.

Overrides: RadForm.OnLoad(EventArgs)

Mirrors the positions of the dialog's interactive controls when its reading direction changes.

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

Event data for the right-to-left change.

Overrides: ScrollableControl.OnRightToLeftChanged(EventArgs)

Applies the dialog's theme name to its nested Telerik controls.

C#
protected override void OnThemeChanged()

Overrides: RadFormControlBase.OnThemeChanged()

Sets the strings values depending on the current localization provider.

C#
protected virtual void SetLocalizedStrings()

Supplies the visual row that displays a strip's name and visibility checkbox.

C#
protected virtual void stripsListControl_CreatingVisualListItem(object sender, CreatingVisualListItemEventArgs args)
Parameters:senderobject

The strips list creating a visual row.

argsCreatingVisualListItemEventArgs

The event data in which to provide the visual item.

Synchronizes the strip selector with the selected row in the strips list.

C#
protected virtual void stripsListControl_SelectedIndexChanged(object sender, PositionChangedEventArgs e)
Parameters:senderobject

The strips list whose selection changed.

ePositionChangedEventArgs

The new selection position.

Supplies the visual row that displays an item's name and visibility checkbox.

C#
protected virtual void toolstripItemsListControl_CreatingVisualListItem(object sender, CreatingVisualListItemEventArgs args)
Parameters:senderobject

The item list creating a visual row.

argsCreatingVisualListItemEventArgs

The event data in which to provide the visual item.

Supplies a data item that exposes a command-bar item's display name and visibility to the list.

C#
protected virtual void toolstripItemsListControl_ItemDataBinding(object sender, ListItemDataBindingEventArgs args)
Parameters:senderobject

The item list requesting a data item.

argsListItemDataBindingEventArgs

The binding event data in which to provide the new item.

Enables the move buttons according to the selected item's position in the list.

C#
protected virtual void toolstripItemsListControl_SelectedIndexChanged(object sender, PositionChangedEventArgs e)
Parameters:senderobject

The item list whose selection changed.

ePositionChangedEventArgs

The new selection position.

Rebuilds the item list from the selected strip and its overflow panel.

C#
protected virtual void toolstripsDownList_SelectedValueChanged(object sender, EventArgs e)
Parameters:senderobject

The strip selector whose selected value changed.

eEventArgs

Event data for the selected-value change.

Synchronizes the strips list selection with the selected strip in the drop-down list.

C#
protected virtual void toolstripsDropDownList_SelectedIndexChanged(object sender, PositionChangedEventArgs e)
Parameters:senderobject

The strip selector whose selection changed.

ePositionChangedEventArgs

The new selection position.

Removes selection, data-binding, and visual-item handlers from the two list controls and unsubscribes from localization-provider changes.

C#
protected virtual void UnwireEvents()

Connects the dialog's close, selection, and localization-provider event handlers.

C#
protected virtual void WireEvents()