RadFontDropDownList
Represents a font dropdown list control that allows users to select fonts from a predefined list of installed fonts. Provides functionality for displaying, selecting, and previewing fonts.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Editors")]
public class RadFontDropDownList : RadPopupEditor, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadEditorControlRadPopupEditorRadFontDropDownList...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadFontDropDownList class with default settings. Creates a dropdown list populated with available system fonts.
public RadFontDropDownList()
Properties
Gets the underlying RadListView control that displays the list of fonts. This provides access to the view for advanced customization.
[Browsable(false)]
public RadListView FontListView { get; }
Gets the name of the font currently being hovered over in the dropdown list. This value changes as the user moves the mouse over different font options when the dropdown is open.
public string PreviewFont { get; }
Gets or sets the maximum number of fonts to display in the Recently Used Fonts group. This determines how many previously selected fonts will be remembered and shown at the top of the list.
public int RecentlyUsedItemsCount { get; set; }
Gets or sets the name of the currently selected font in the dropdown list. Setting this property will update the display and trigger the SelectedFontChanged event.
public string SelectedFont { get; set; }
Gets or sets a value indicating whether the font preview changes as the user hovers over different font options. When enabled, hovering over a font in the dropdown list will temporarily select it for preview.
public bool SelectOnHover { get; set; }
Gets or sets a value indicating whether the Recently Used Fonts group is displayed in the dropdown list. When true, fonts that have been previously selected will appear in a separate group at the top of the list.
public bool ShowRecentlyUsedFonts { get; set; }
Gets the theme class name used for styling this control.
public override string ThemeClassName { get; }
The fully qualified name of the RadDropDownList type.
Overrides:
Methods
Adds a font family to the list of available fonts in the dropdown.
public virtual void AddFont(FontFamily fontFamily)
The FontFamily to add to the font list.
Adds a font family to the list of available fonts in the dropdown by specifying its name.
public virtual void AddFont(string fontFamilyName)
The name of the font family to add to the font list.
Creates the editor element used by this control.
protected override RadPopupEditorElement CreateElement()
A new instance of RadFontPopupEditorElement.
Overrides:
Removes a font family from the list of available fonts in the dropdown.
public virtual void RemoveFont(FontFamily fontFamily)
The FontFamily to remove from the font list.
Removes a font family from the list of available fonts in the dropdown by specifying its name.
public virtual void RemoveFont(string fontFamilyName)
The name of the font family to remove from the font list.
This method is not relevant for this class.
public override void SetAssociatedControlRuntime(RadPopupContainer associatedControl)
The associated control to set.
Overrides:
Events
Occurs when the user hovers over a different font in the dropdown list, changing the preview font. This event is only raised when the SelectOnHover property is set to true.
public event SelectedFontEventHandler PreviewFontChanged
Occurs when the selected font in the dropdown list changes, either through user interaction or programmatically.
public event SelectedFontEventHandler SelectedFontChanged