In This Topic ▼

ANNTEXTTOKEN

Summary

The ANNTEXTTOKEN structure contains information about the tokens for an annotation object.

Syntax

typedef struct tagANNTEXTTOKEN 
{ 
   L_UINT uStructSize; // sizeof this structure 
   L_TCHAR cToken; // character representing the token 
   L_TCHAR *pszDesc; // description of the token 
   L_TCHAR *pszTokenString; // definition of the token 
   ANNTEXTTOKENTYPE nTokenType; // constant defining the type of token 
   L_INT nReserved; // reserved for future use 
} ANNTEXTTOKEN, *pANNTEXTTOKEN;

Members

uStructSize

Size of this structure. Use sizeof(ANNTEXTTOKEN)

cToken

Character representing the token. This can be ANY ASCII character EXCEPT #, because the token ## is reserved to display the # character.

pszDesc

Pointer to a text string that describes the token. This string appears on the text token table menu. For example, the string for token #0 in the default text token table is "Two Digit Month". The text token table menu is displayed by:

Right-clicking on a Button, Note, PushPin, Rubber Stamp, Stamp, Text, or Text Pointer annotation object.
Select Text option in menu that appears.
Click the Insert Token button. A menu for the existing text token table appears, as shown in the following figure:

$image\TokenTable2.gif$
Select the token to be inserted.

pszTokenString

This member is used only if nTokenType is ANNTOKEN_TEXT. If nTokenType is not ANNTOKEN_TEXT, then pszTokenString is ignored. The pszTokenString can be any combination of existing token strings, or any new string.

nTokenType

Identifies the type of token. Must be one of the constants in the following:

Value	Meaning
ANNTOKEN_NONE	[0] String not treated as a token
ANNTOKEN_SEPARATOR	[1] Add a separator to the automation token menu
ANNTOKEN_TEXT	[2] A text string
ANNTOKEN_DATE_YYYY	[3] Current four digit year
ANNTOKEN_DATE_YY	[4] Current two digit year
ANNTOKEN_DATE_MM	[5] Two digit representation of current month
ANNTOKEN_DATE_DD	[6] Two digit representation of current day
ANNTOKEN_DATE_MONTH_NAME	[7] Current month name (i.e. January)
ANNTOKEN_DATE_DAY_OF_WEEK	[8] Current day of week (i.e. Monday)
ANNTOKEN_TIME_HH_12	[9] Current hour,using a 12 hour clock
ANNTOKEN_TIME_HH_24	[10] Current hour, using a 24 hour clock
ANNTOKEN_TIME_MM	[11] Current minute (00-59)
ANNTOKEN_TIME_SS	[12] Current second (00-59)
ANNTOKEN_TIME_MILLISECONDS	[13] Current milliseconds (000-999)
ANNTOKEN_AM_PM	[14] Time of day indicator (AM or PM)

nReserved

Reserved for future use. Set this member to 0.