Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxCustomLayoutControl.OnGetItemStoredPropertyValue Event

In This Article

Enables you to specify the layout element custom setting’s value.

#Declaration

Delphi
property OnGetItemStoredPropertyValue: TdxLayoutControlGetItemStoredPropertyValueEvent read; write;

#Remarks

Fires when storing layout element settings to the storage, and after the OnGetItemStoredProperties event.

When customizing the list of layout element settings that will be stored in external storage using the OnGetItemStoredProperties event handler, it is necessary to specify the custom setting’s value, using the OnGetItemStoredPropertyValue event handler.

Sender specifies the layout control that owns AItem.

AItem specifies the layout element whose setting will be stored.

AName specifies the setting to be stored.

AValue specifies the setting’s value.

The following example shows how to handle the OnGetItemStoredPropertyValue event in order to store the enabled state of standard layout items. It specifies the value of the ControlEnabled setting which was added to the list by an OnGetItemStoredProperties event handler:

Delphi
procedure <TForm1>.<dxLayoutControl1>GetItemStoredPropertyValue(
  Sender: TdxCustomLayoutControl; AItem: TdxCustomLayoutItem;
  const AName: string; var AValue: Variant);
begin
  if (AName = 'ControlEnabled') and Assigned(TdxLayoutItem(AItem).Control) then
    AValue := TdxLayoutItem(AItem).Control.Enabled;
end;

To learn how to add the ControlEnabled setting to the list, refer to the example in the OnGetItemStoredProperties help topic.

See Also