This method is called after appendspan, appendObject, appendfmtMark and checks to see if there is an invalid strux just before. If it see one, it marks the strux as suspect for verification after the load is over. Really useful for importers.

This method deletes a strux of the type specified at the position requested. if bRecordChange is fale no change record is recorded. This method was created soled for the use of AbiCollab. Use with extreme care. Should only be needed by AbiCollab

If the input pAP contains revision attribute, this function returns AP in which the revision attribute has been inflated into actual properties and attributes (the return AP lives in the PT varset, so it is not to be modified, deleted, etc., but the caller)

bShow indicates whether revisions are shown or hidden (view - dependent) iId is the id of revision to be shown (view - dependent)

on return bHiddenRevision indicates if the element associated with pAP is to be hidden or visible

Some exporters (RTF) need to know the visual direction at each position in the document as it is being exported. The problem is that visual direction is a property of the layout not of the document itself (I shall not make any comments about badly designed file formats here!). Since our document is not directly aware of any of its layouts, we have to find a listener for FL_DocLayout that is registered with this document (it does not matter if there are more FL_DocLayout listeners registered, the visual direction will be same for all, so we grab the first one), and from the listener we can get access to the layout, down to the runs which carry the information that we need. Tomas, May 3, 2003

Starting to search this document at position pos where the two documents are known to become different, attepts to find location at which similarities resume

Parameters:

pos,:

when called, should contain offset in present document at which the difference starts; on successfult return it will contain offset in present document where similarities resume

iOffset2,:

when called contains offset to be added to position pos in order to correctly position start of the search in document d; on return it contains offset to be add to pos in order to obtain correct location of the resumption of similarites in document d

iKnownLength,:

on return contains the minium guaranteed length of the similarity

d

the document to which this document is to be compared

Returns:

returns true if it succeeds; if no further similarities are found returns false

This function evaluates the xid value for the given frament and version level.

The XID is a document-unique identifier of the frag; when we compare documents, we are interested not in document uniqueness but global uniqueness. We convert the document-unique xid to a globaly unique id by combining the xid with the UUID of document version: identical xid's in two documents represent identical elements if, and only if, the version UUIDs for the version of the document in which the element was created are identical. Therefore, as a part of the version record, we store the highest xid used in the document. This way we can determine in which version of the document the frag was created, based on its xid.

Frags that have xid aboved the version threshold need to be treated as frags without xid.

This method inserts a strux of type pts immediately before the sdh given. Attributes of the strux can be optionally passed. This method does not throw a change record and should only be used under exceptional circumstances to repair the piecetable during loading. It was necessary to import RTF tables.

This function crawls over the entire document and removes all fmt marks. It is principally meant to do PT clean up on import (for example, the structure of MS Word documents is such that we end up with a myriad of superfluous fmt marks in the document), and should be called by an importer at the end of import process.

Sets document attributes and properties can only be used while loading documents

Parameters:

const

gchar ** ppAttr: array of attribute/value pairs

if ppAttr == NULL and m_indexAP == 0xffffffff, the function creates a new AP and sets it to the default values hardcoded in it

if ppAttr == NULL and m_indexAP != 0xffffffff, the function does nothing

if ppAttr != NULL the function overlays passed attributes over the existing attributes (creating a new AP first if necessary)

When initialising document attributes and props, we need to set m_indexAP to 0xffffffff and then call setAttributes(NULL).

Importers should just call setAttributes(NULL) in the initialisation stage, this ensures that default values are set without overwriting existing values if those were set by the caller of the importer.