MiniCalendar Marker Token

Navigation:  Tokens > MiniCalendar Tokens >

MiniCalendar Marker Token

Previous pageReturn to chapter overviewNext page

The MiniCalendar Marker Token is of the form :

 

[DayValue mc+XX Modifiers]   or   [DayValue mcXXX Modifiers]

 

Where :

 

DayValue corresponds to the usual DayValue used in all tokens.

 

Modifiers can be a series of one,or more, or none, Minicalendar Modifiers which can be included in the MiniCalendar Marker Token to achieve various effects.

 

XX and XXX represent the month of the minicalendar as calculated based on the date corresponding to the DayValue above. The possible values for XX and XXX will be discussed later in this topic.

 

The markers above, mc+XX and mcXXX, correspond to the 2 forms that a minicalendar marker token can take : relative and absolute.

 

Relative : [mc-99] to [mc+99], corresponding to the month 99 month ago, to the month 99 months into the future. Usual values are [mc+00], current month, and [mc+01], following month.

 

Absolute : [mc001] to [mc012] referring to the months of January to December for the year of the date corresponding to the token's DayValue.

 

Specific example of these 2 forms are :

 

[4mc+00]

Current month based on the date of DayValue 4

[1mc001]

Month of January based on the date of DayValue 1

 

Note that :

 

The spaces placed in the above examples are there to make the structure easier to see, but there should be no spaces in minicalendar marker tokens.

 

There is no LanguageTag because each token or marker that will follow defines its own language tag (allowing for the use of many languages in the same minicalendar.

 

It marks the textbox as a MiniCalendar textbox, and it resets the current date for all tokens which follow it inside the textbox.

 

Marking the textbox as a MiniCalendar textbox tells Q++ that it should interpret the symbols which follow ($$, $a, w#, @). These have a meaning only within a MiniCalendar textbox.

 

Resetting the date is a bit subtle and can lead, at first, to unexpected output. Let us analyze the above example. The MiniCalendar token has a DayValue of 4 corresponding to July 2nd 2000. The +00 which follows the mc means that this MiniCalendar represents the current month, July 2000. The date for DayValue=1 of all the tokens that follow [4mc+00] is thus reset to July 1st 2000 (the beginning of the month). The following token, [MMMM], is thus evaluated as JULY, even though anywhere else in the GridTemplate its DayValue=1 would represent June 29th.

 

Finally, note that the minicalendar marker token is always replaced by a blank in the ouput file, and therefore it is usual to set their font size to a very small point size, usually 4 or 5, so they do not clutter the GridTemplate.


Topic 108930 updated on 13-May-2016.
Topic URL: http://www.qppstudio.net/webhelp/index.html?minicalendarmarker.htm