GetAnchor()

This function should provide the anchor name used for external graphics referenced with <a xmlns:xlink= xlink href=> tags, heading-level table of contents entries, and external files (such as CSS files and revision summary files).

The anchor name you provide is passed into GetAuxOutput() to identify the output stream if defined, otherwise it is used as the auxiliary file name.

Syntax

BOOL (pascal *GetAnchor)  (
    void                    *pCallingContext,
    KVXMLAnchorType          eAnchorType,
    char                    *pszAnchor,
    int                      cbAnchorMax,
    BYTE                    *pcHTML,
    UINT                     cbHTML);

Arguments

pCallingContext

A pointer that gets passed back to the caller-provided callback functions. This pointer, which can be NULL, is specified as the second parameter of the call to fpConvertStream().

eAnchorType

The anchor type for the output stream. It must be one of the enumerated types defined in KVXMLAnchorType.

pszAnchor

A pointer to the memory that you should write the new anchor to.

cbAnchorMax

The maximum number of bytes to place in pszAnchor.

pcHTML

KeyView will have set this to either NULL or a pointer to one of the following:

  • markup defining the contents of a table of contents entry

  • the external graphic file name

  • the external file name

cbHTML

The number of valid bytes in pcHTML.

Returns

Discussion