THotPDF.InsertLoadedNameTreeEntry Method
Fügt ein Schlüssel/Wert-Paar in einen geladenen Name-Tree ein und hält jedes Blatt nach ISO 32000-1 7.9.6 sortiert
Deklaration
procedure InsertLoadedNameTreeEntry(Tree: THPDFDictionaryObject;
const Key: AnsiString; Value: THPDFObject);Unit
HPDFDoc
Parameter
| Name | Zweck |
|---|---|
Tree | Wurzelknoten eines Name-Trees, üblicherweise aus GetLoadedNameTree |
Key | Sortierter Schlüssel-String des Eintrags |
Value | Für den Schlüssel gespeichertes PDF-Objekt; der Tree übernimmt nur die Verantwortung für die Einfügeposition, das Objekt bleibt Teil des geladenen Objektgraphen |
Rückgabewert
Dieses Element gibt keinen Wert zurück
Verwendungshinweise
- Ein Tree mit /Kids wird über die /Limits seiner Nodes hinab durchlaufen, und die Limits auf dem Weg werden erweitert, sodass sie den neuen Schlüssel abdecken; Betrachter können dadurch weiter binär über die Blätter suchen
- Wird ein bereits vorhandener Schlüssel eingefügt, ersetzt das seinen Wert, statt ein Duplikat anzuhängen
- Jeder Node auf dem Abstiegspfad wird als dirty markiert, damit die Änderung beim nächsten Speichern oder inkrementellen Update zurückgeschrieben wird