THotPDF.RegisterCustomStreamFilter
Hält einen anwendungsdefinierten Decoder unter seinem normalisierten PDF-Filternamen vor
Deklaration
function RegisterCustomStreamFilter(
const CustomFilter: IHPDFCustomStreamFilter;
ReplaceExisting: Boolean = False): Boolean;
Parameter
CustomFilter liefert Name, Modus, Seek-Verträge und die Decoder-Implementierung
ReplaceExisting erlaubt einen atomaren Austausch, wenn der normalisierte Name bereits existiert
Rückgabewert
Liefert True nach dem Einfügen oder Ersetzen und False bei einem Duplikat, wenn das Ersetzen deaktiviert ist
Verwendungshinweise
- Nil-Interfaces, ungültige PDF-Namen, eingebaute Namen und eine Registry mit mehr als 64 Einträgen lösen eine Argument- oder Range-Exception aus
- Beim Namensvergleich wird die Groß-/Kleinschreibung ignoriert, und ein führender Schrägstrich bleibt unberücksichtigt
- Die Registry hält das Interface bis zum Ersetzen, Entfernen, Leeren oder bis zur Zerstörung des Dokuments
- Die nebenläufige Decoder-Suche erstellt einen Interface-Snapshot, bevor sie das Registry-Lock freigibt