NNS_G2dTextCanvasDrawTaggedText

Syntax


#include <nnsys/g2d/g2d_TextCanvas.h>

void NNS_G2dTextCanvasDrawTaggedText(
    const NNSG2dTextCanvas* pTxn,
    int x,
    int y,
    int cl,
    const NNSG2dChar* txt,
    NNSG2dTagCallback cbFunc,
    void* cbParam
);

Arguments

pTxn [IN] Pointer to TextCanvas
x [IN] Coordinate at start of drawing (in CharCanvas coordinate system)
y [IN] Coordinate at start of drawing (in CharCanvas coordinate system)
cl [IN] Standard color No. to use for text-string drawing
txt [IN] Pointer to text string
cbFunc [IN] Pointer to tag callback function
cbParam [IN] User parameter for callback function

Return Values

None.

Description

Draws text strings that have embedded tags. This function itself does not process any tags. It is left up to the callback function to conduct all tag processing.

Drawing starts at the upper-left corner of the first text character, as defined by (x, y).

For text characters with character codes 0x0020 and above and for '\n' (0x0A) & '\0', this function handles drawing and processing just like NNS_G2dTextCanvasDrawText. But when other text characters appear (characters with character codes at or below 0x001F), this function calls the callback function cbFunc.

When a vertically written font is used, this function will draw a text string with the point given by (x, y) at the upper right corner of the first character.

See Also

NNS_G2dTextCanvasDrawText, NNSG2dTagCallback

Revision History

2007/03/14 Added support for vertically written/vertically held fonts.
2005/05/25 Initial version.

CONFIDENTIAL