ReleaseStringList

Diverse funktioner

Beskrivning

Släpper en stränglista som en annan API-funktion tidigare returnerat (till exempel CheckFileCompliance). Efter detta anrop är StringListID-handle:t inte längre giltigt och får inte skickas till GetStringListCount eller GetStringListItem

Syntax

Delphi

Function TPDFlib.ReleaseStringList(StringListID: Integer): Integer;

ActiveX

Function PDFlib::ReleaseStringList(StringListID As Long) As Long

DLL

int DLReleaseStringList(int InstanceID, int StringListID);

Parametrar

StringListID	ID:t för den stränglista som ska släppas, som tidigare returnerats av en produktionsfunktion

Returvärden

0	StringListID är ogiltigt eller refererar inte en stränglista som denna instans äger
1	Listan släpptes utan problem

Anmärkningar

Stränglistor ägs av den PDFlib-instans som producerade dem. De frigörs automatiskt när instansen förstörs, så explicit släpp är normalt valfritt. Anropa ReleaseStringList i långlivade processer som producerar många listor (till exempel en CI-arbetare som validerar hundratals PDF:er i sekvens) för att hålla minnesanvändningen begränsad

Exempel

// Validate many files in a loop, releasing each result list as soon as it has been logged
var
  I, Issues, Count, J: Integer;
begin
  for I := 0 to Files.Count - 1 do
  begin
    Issues := PDF.CheckFileCompliance(Files[I], '', 1, 0);
    if Issues <> 0 then
    begin
      Count := PDF.GetStringListCount(Issues);
      for J := 1 to Count do
        WriteLn(Files[I], ' : ', PDF.GetStringListItem(Issues, J));
      PDF.ReleaseStringList(Issues);
    end;
  end;
end;

Se även

GetStringListCount, GetStringListItem, CheckFileCompliance