TcxTreeListBand.OnGetStoredPropertyValue Event

Enables you to provide values for band 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 band’s OnGetStoredProperties event handler. To restore band properties, handle the OnSetStoredPropertyValue event.

The Sender parameter specifies the current band.

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 band’s Expandable property previously specified for storing within the band’s OnGetStoredProperties event handler.

Delphi

procedure <Form>.<Band>GetStoredPropertyValue(Sender: TObject; const AName: String; var AValue: Variant);
begin
  if Sender is TcxTreeListBand then
  begin
    if AName = 'Expandable' then
    begin
      AValue := TcxTreeListBand(Sender).Expandable;
      Exit;
    end;
  end;
end;

C++

void __fastcall <Form>::<Band>GetStoredPropertyValue(TObject *Sender, const AnsiString AName, Variant &AValue)
{
  if(AName == "Expandable") {
    if(dynamic_cast<TcxTreeListBand*>(Sender)) {
      TcxTreeListBand * ABand = (TcxTreeListBand *)Sender;
      AValue = ABand->Expandable;
      return;
    }
  }
}