TerGetSeqSect
Translate a section id into the sequential section number.
int TerGetSeqSect( SectId)
int SectId; | Section id for the text. |
Description: This function translates the section id into the sequential section numbers. Please note that the section id assigned to the text are not sequential. For example, in a document containing 3 sections, it is not correct to assume id 0 for the first section, or id 1 for the subsequent section of the document. Most APIs involving section need you to specify the section id. A section id can be retrieved using the GetTerFields or TerGetPageSect functions. However, certain functions such as TerPosBodyText and TerPosHdrFtr need the sequential section number for the section argument. For the purpose of differentiation, this manual uses the term 'section id' or 'sequential section number' as appropriate.
Return Value: The function returns the sequential section number when successful. Otherwise it returns -1.