Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]Controls and Libraries
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.Charts.Designer
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.UI.Interactivity
  [Expand]DevExpress.Mvvm.UI.ModuleInjection
  [Expand]DevExpress.Xpf.Accordion
  [Expand]DevExpress.Xpf.Bars
  [Expand]DevExpress.Xpf.Carousel
  [Expand]DevExpress.Xpf.Charts
  [Expand]DevExpress.Xpf.Charts.Localization
  [Expand]DevExpress.Xpf.Charts.RangeControlClient
  [Expand]DevExpress.Xpf.ChunkList
  [Expand]DevExpress.Xpf.Controls
  [Expand]DevExpress.Xpf.Core
  [Expand]DevExpress.Xpf.Core.ConditionalFormatting
  [Expand]DevExpress.Xpf.Core.DataSources
  [Expand]DevExpress.Xpf.Core.ServerMode
  [Expand]DevExpress.Xpf.Data
  [Expand]DevExpress.Xpf.DataAccess
  [Expand]DevExpress.Xpf.DataAccess.DataSourceWizard
  [Expand]DevExpress.Xpf.Diagram
  [Expand]DevExpress.Xpf.Docking
  [Expand]DevExpress.Xpf.Docking.Base
  [Expand]DevExpress.Xpf.DocumentViewer
  [Expand]DevExpress.Xpf.Editors
  [Expand]DevExpress.Xpf.Editors.DateNavigator
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor
  [Expand]DevExpress.Xpf.Editors.Filtering
  [Expand]DevExpress.Xpf.Editors.Flyout
  [Expand]DevExpress.Xpf.Editors.Flyout.Native
  [Expand]DevExpress.Xpf.Editors.Helpers
  [Expand]DevExpress.Xpf.Editors.Popups
  [Expand]DevExpress.Xpf.Editors.RangeControl
  [Expand]DevExpress.Xpf.Editors.Settings
  [Expand]DevExpress.Xpf.Editors.Validation
  [Expand]DevExpress.Xpf.Gauges
  [Expand]DevExpress.Xpf.Gauges.Localization
  [Expand]DevExpress.Xpf.Grid
  [Expand]DevExpress.Xpf.Grid.ConditionalFormatting
  [Expand]DevExpress.Xpf.Grid.LookUp
  [Expand]DevExpress.Xpf.Grid.TreeList
  [Expand]DevExpress.Xpf.Layout.Core
  [Collapse]DevExpress.Xpf.LayoutControl
   [Expand]DataLayoutControl Class
   [Expand]DataLayoutControlAutoGeneratedGroupEventArgs Class
    DataLayoutControlAutoGeneratedItemsLocation Enumeration
   [Expand]DataLayoutControlAutoGeneratingItemEventArgs Class
   [Expand]DataLayoutItem Class
    Dock Enumeration
   [Expand]DockLayoutControl Class
   [Expand]FlowLayoutControl Class
   [Expand]GroupBox Class
    GroupBoxDisplayMode Enumeration
    GroupBoxShadowVisibility Enumeration
    GroupBoxState Enumeration
   [Collapse]LayoutControl Class
     LayoutControl Members
     LayoutControl Constructor
    [Expand]LayoutControl Properties
    [Expand]LayoutControl Events
    [Collapse]LayoutControl Methods
      GetAllowHorizontalSizing Method
      GetAllowVerticalSizing Method
      GetCustomizationDefaultLabel Method
      GetCustomizationLabel Method
      GetIsUserDefined Method
      GetTabHeader Method
      GetTabHeaderTemplate Method
      GetUseDesiredHeightAsMaxHeight Method
      GetUseDesiredWidthAsMaxWidth Method
      ReadFromXML Method
      SetAllowHorizontalSizing Method
      SetAllowVerticalSizing Method
      SetCustomizationLabel Method
      SetIsUserDefined Method
      SetTabHeader Method
      SetTabHeaderTemplate Method
      SetUseDesiredHeightAsMaxHeight Method
      SetUseDesiredWidthAsMaxWidth Method
   [Expand]LayoutControlBase Class
   [Expand]LayoutControlInitNewElementEventArgs Class
   [Expand]LayoutControlReadElementFromXMLEventArgs Class
   [Expand]LayoutControlWriteElementToXMLEventArgs Class
   [Expand]LayoutGroup Class
    LayoutGroupView Enumeration
   [Expand]LayoutItem Class
    LayoutItemLabelPosition Enumeration
    LayoutItemLabelsAlignment Enumeration
    MaximizedElementPosition Enumeration
   [Expand]ScrollBox Class
   [Expand]Tile Class
   [Expand]TileClickEventArgs Class
   [Expand]TileLayoutControl Class
    TileSize Enumeration
  [Expand]DevExpress.Xpf.Map
  [Expand]DevExpress.Xpf.NavBar
  [Expand]DevExpress.Xpf.Navigation
  [Expand]DevExpress.Xpf.PdfViewer
  [Expand]DevExpress.Xpf.PivotGrid
  [Expand]DevExpress.Xpf.PivotGrid.Printing
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpf.Printing.Parameters
  [Expand]DevExpress.Xpf.Printing.Parameters.Models
  [Expand]DevExpress.Xpf.Printing.PreviewControl.Bars
  [Expand]DevExpress.Xpf.Prism
  [Expand]DevExpress.Xpf.PropertyGrid
  [Expand]DevExpress.Xpf.Reports.UserDesigner
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Extensions
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Localization
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages
  [Expand]DevExpress.Xpf.Ribbon
  [Expand]DevExpress.Xpf.RichEdit
  [Expand]DevExpress.Xpf.Scheduler
  [Expand]DevExpress.Xpf.Scheduler.Drawing
  [Expand]DevExpress.Xpf.Scheduler.Menu
  [Expand]DevExpress.Xpf.Scheduler.Reporting
  [Expand]DevExpress.Xpf.Scheduler.UI
  [Expand]DevExpress.Xpf.SpellChecker
  [Expand]DevExpress.Xpf.Spreadsheet
  [Expand]DevExpress.Xpf.Spreadsheet.Menu
  [Expand]DevExpress.Xpf.TreeMap
  [Expand]DevExpress.Xpf.Utils.Themes
  [Expand]DevExpress.Xpf.WindowsUI
  [Expand]DevExpress.Xpf.WindowsUI.Navigation
  [Expand]DevExpress.XtraRichEdit
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

LayoutControl.GetCustomizationDefaultLabel Method

Gets the default label for a layout item, when this item is displayed in the Available Items List.

Namespace:DevExpress.Xpf.LayoutControl
Assembly:DevExpress.Xpf.LayoutControl.v17.1.dll

Expanded Syntax

Parameters

element
Type: UIElement
An element whose default customization label is to be returned.

Return value

Type: String
A string that specifies the default label for a layout item, when this item is displayed in the Available Items List.

Expanded Remarks

Default customization labels are calculated for items by the GetCustomizationDefaultLabel function. To provide custom customization labels, use the CustomizationLabel attached property.

The following table shows the values returned by the GetCustomizationDefaultLabel function for various layout elements:

Element Return Value
ContentControl ContentControl.Content

If this value is null or an empty string, the name of the element's type is returned, wrapped with square brackets.

Descendants of DevExpress.Xpf.Core.ContentControlBase (e.g. GroupBox) ContentControlBase.Content

If this value is null or an empty string, the name of the element's type is returned, wrapped with square brackets.

LayoutGroup LayoutGroup.Header

If this value is null or an empty string, the name of the element's type is returned, wrapped with square brackets.

LayoutItem LayoutItem.Label

If this value is null or an empty string, the name of the element's type is returned, wrapped with square brackets.

Other cases

The name of the element's type is returned, wrapped with square brackets.

Expanded See Also

How would you rate this topic?​​​​​​​