(Delphi ActiveX) XMP Array Property - Bag, Seq, or Alt

How to insert or update an XMP array property (bag, seq, or alt).

Chilkat for Delphi Downloads Chilkat ActiveX DLL for Delphi Chilkat non-ActiveX DLL for Delphi * The examples here use the ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Chilkat_TLB;

...

procedure TForm1.Button1Click(Sender: TObject);
var
xmp: TChilkatXmp;
success: Integer;
xml: IChilkatXml;
sa: TCkStringArray;

begin
// This requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

xmp := TChilkatXmp.Create(Self);

// Load a JPG or TIF image file.
// Sample JPG's with XMP metadata may be found at:
// http://www.chilkatsoft.com/testData/xmp/sample1.jpg
// http://www.chilkatsoft.com/testData/xmp/sample2.jpg
// http://www.chilkatsoft.com/testData/xmp/sample3.jpg
success := xmp.LoadAppFile('sample1.jpg');
if (success <> 1) then
  begin
    Memo1.Lines.Add(xmp.LastErrorText);
    Exit;
  end;

Memo1.Lines.Add('Num embedded XMP docs: ' + IntToStr(xmp.NumEmbedded));

// Assuming there is at least one, get the 1st.
// (There is typically never more than one, but theoretically it's possible.)

xml := xmp.GetEmbedded(0);
if (xmp.LastMethodSuccess = 1) then
  begin

    // Create an object to hold one or more string values.
    sa := TCkStringArray.Create(Self);
    success := sa.Append('value_1');
    success := sa.Append('value_2');
    // ...

    success := xmp.AddArray(xml,'bag','Iptc4xmpCore:Chilkat',sa.ControlInterface);
    if (success <> 1) then
      begin
        Memo1.Lines.Add(xmp.LastErrorText);
      end
    else
      begin
        // Save the JPG.
        success := xmp.SaveAppFile('modified.jpg');
        if (success <> 1) then
          begin
            Memo1.Lines.Add(xmp.LastErrorText);
          end;

      end;

  end
else
  begin
    Memo1.Lines.Add(xmp.LastErrorText);
  end;
end;