THotPDF.FindStructureElementForMCID-methode
Lost het StructElem-woordenboek op dat een gegeven gemarkeerde-inhoudreeks (pagina, MCID) bezit, door de pagina-/StructParents-sleutel te lezen en in constante tijd te indexeren in de document-ParentTree
Declaratie
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;
Eenheid
HPDFDoc
Parameters en resultaat
| Waarde | Doel |
|---|---|
PageIndex | Nulgebaseerde pagina-index waarvan de gemarkeerde inhoud wordt opgelost |
MCID | Gemarkeerde-inhoudidentificator die op de pagina wordt uitgevoerd en door AddStructureElement in de ParentTree wordt bedraad |
| Resultaat | Het eigenaar indirecte StructElem-woordenboek, of nil wanneer de pagina niet is getagd, de sleuf leeg is of een van beide argumenten buiten bereik ligt |
Gedrag
- Leest het pagina-
/StructParents-geheel en retourneert dan rechtstreeksFParentTree[key][MCID], zodat de opzoeking onafhankelijk is van het aantal structuurelementen - Indirecte StructElem-verwijzingen worden in een koppeling binnen de ParentTree opgeslagen; de methode lost de koppeling op naar het doelwoordenboek vóór terugkeer
- De methode werpt nooit een uitzondering: een ongetagde pagina, een niet-toegewezen MCID, een
/null-plaatshouder-sleuf of buiten-bereik-argumenten vallen allemaal samen opnil - Het geretourneerde element is hetzelfde indirecte dict dat door
AddStructureElementis geproduceerd en is geschikt als/SD-doel vanAddStructureDestinationLink