TPdfObjectList.ArrangeObject

Declaration

function ArrangeObject(OldIndex, NewIndex: Integer): Boolean; overload;
function ArrangeObject(PdfObject: TPdfObject; NewIndex: Integer): Boolean; overload;

Description

Arranges an object to a new position in the z-order of the page.
Objects with a lower index are further to the back, whereas objects with a higher index are toward the top, i.e. Object of index 0 is at the very back, where Count-1 would be at the top (in front of any other objects that it overlaps).
You can specify MAXINT for NewIndex to bring an object to the front.

Note: You must call ApplyChanges before saving to apply object changes to the document

Examples

// Bring the highlighted object forward
ImageEnView1.PdfViewer.Objects.ArrangeObject( ImageEnView1.PdfViewer.SelectedObject, ImageEnView1.PdfViewer.SelectedObject + 1 );

// Send the highlighted object backward
ImageEnView1.PdfViewer.Objects.ArrangeObject( ImageEnView1.PdfViewer.SelectedObject, ImageEnView1.PdfViewer.SelectedObject - 1 );

// Bring the highlighted object to the front (overlapping all other objects)
ImageEnView1.PdfViewer.Objects.ArrangeObject( ImageEnView1.PdfViewer.SelectedObject, MAXINT );

// Send the highlighted object to the back (behind all other objects)
ImageEnView1.PdfViewer.Objects.ArrangeObject( ImageEnView1.PdfViewer.SelectedObject, 0);

// Add a watermark image to a PDF page
procedure TfrmMain.AddWatermarkImage(const WatermarkFilename: string);
begin
  // Load image into page at full size of the page
  obj := ImageEnView1.PdfViewer.Objects.AddImage( 0, 0, ImageEnView1.PdfViewer.PageWidth, ImageEnView1.PdfViewer.PageHeight, WatermarkFilename, False );

  // Send image behind all other images (it will be the last object)
  ImageEnView1.PdfViewer.Objects.ArrangeObject( obj, 0 );
end;

TPdfObjectList.ArrangeObject