fpGetAnchor()
This function gets the file name automatically generated by Export and used for external graphics referenced with <img> tags and for heading-level table of contents entries.
Syntax
BOOL pascal fpGetAnchor( void *pCallingContext, KVHTMLAnchorTypeEx eAnchorTypeEx, KVXMLAnchorType eAnchorType, char *pszAnchor, int cbAnchorMax, BYTE *pcHTML, UINT cbHTML);
Arguments
|
|
A pointer passed back to the callback functions. |
|
|
The graphic or block anchor type for the output stream. It must be one of the enumerated types defined in |
|
|
A pointer to the location in which the new anchor is stored. |
|
|
The maximum number of bytes to place in |
|
|
A pointer to either the markup defining the contents of the table of contents entry, a pointer to the external graphic name, or |
|
|
The number of valid bytes in |
Returns
-
If the call is successful, the return value is
TRUE. -
If this call is unsuccessful, the return value is
FALSE. Processing is halted.
Discussion
-
pszAnchormust be assigned. It might be derived from thecbAnchorMax,pcHTML, andcbHTMLvalues that are also provided. -
pcHTMLcan beNULLif the graphic is an internal part of the document. -
This function is exposed so that it can be called from the
GetAnchor()callback function to obtain default behavior for anchor types the callback is not set to handle.