TcxTreeListColumn.OnGetStoredPropertyValue Event

Enables you to provide values for column properties to be saved to external data stores.

Declaration

property OnGetStoredPropertyValue: TcxGetStoredPropertyValueEvent read; write;

Remarks

This event is fired for each property (including default properties) within the list specified in the column’s OnGetStoredProperties event handler. To restore column properties, handle the OnSetStoredPropertyValue event.

The Sender parameter specifies the current column.

The AName parameter identifies the property name.

Pass the property value as the AValue parameter.

The following code represents an OnGetStoredPropertyValue event handler demonstrating how to save the values of a column’s Options.Footer property previously specified for storing within the column’s OnGetStoredProperties event handler.

Delphi

procedure TMyForm.cxTreeList1GetStoredPropertyValue(Sender: TObject; const AName: String; var AValue: Variant);
begin
  if Sender is TcxTreeListColumn then
  begin
    if AName = 'Options_Footer' then
    begin
      AValue := TcxTreeListColumn(Sender).Options.Footer;
      Exit;
    end;
  end;
end;

C++

void __fastcall TMyForm::cxTreeList1GetStoredPropertyValue(TObject *Sender, const AnsiString AName, Variant &AValue)
{
  if(AName == "Options_Footer") {
    if(Sender->InheritsFrom(TcxTreeListColumn)) {
      TcxTreeListColumn *AColumn = dynamic_cast<TcxTreeListColumn*>(Sender);
      AValue = AColumn->Options->Footer;
      return;
    }
  }
}