Skip to main content

LayoutControl.RegisterFixedItemType(Type) Method

Registers the specified ‘fixed’ item for runtime use in the LayoutControl.

Namespace: DevExpress.XtraLayout

Assembly: DevExpress.XtraLayout.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

public virtual void RegisterFixedItemType(
    Type itemType
)

Parameters

Name Type Description
itemType Type

The type of the ‘fixed’ item to be registered.

Remarks

Predefined items that are displayed first and painted bold in the Customization Form are called “fixed”. These items are not instances, but rather types of items. When any of the ‘fixed’ items is dragged and dropped from the Customization Form onto the Layout Control, an instance of the corresponding item is created within the layout. The item is not hidden from the Customization Form. The LayoutControl supports the following ‘fixed’ items: Empty Space Items, Label, Separator and Splitter.

The RegisterFixedItemType method allows you to register a custom ‘fixed’ item for runtime use. First, create a ‘fixed’ item by deriving it from the LayoutControlItem class and implementing the DevExpress.XtraLayout.IFixedLayoutControlItem interface. Then, register the ‘fixed’ item with the RegisterFixedItemType method. See How to: Create custom ‘fixed’ item, for an example.

When registering multiple custom ‘fixed’ items, wrap the registration code with the LayoutControl.HiddenItems.BeginRegistration and LayoutControl.HiddenItems.EndRegistration method pair to avoid superfluous updates.

See Also