Please enable JavaScript to view this site.

 

Navigation: Script Line Properties > MiniCalendars > Understanding

Formatting Sequence of Dates in Minicalendars

Scroll Prev Up Next More

An important aspect of mini-calendar options is that the groups of options of the mini-calendar property editors are not mutually exclusive.

 

Default Behavior

 

Several formatting groups can apply to the same date. For example, a date may qualify for both Current Week and Current Day formatting.

 

That same date could also correspond to an occurrence of a holidays list used in the mini-calendar option, as well as correspond to a moon phase.

 

Default Sequence

 

By default, attributes are applied (or removed) in the following sequence: current month, current week, current day, holidays, outside days, and finally moon phases (looking at the property editor, the order goes from top to bottom and then from left to right, as shown in the image on the right).

 

This default sequence can be changed as described in the overriding the default sequence section below.

 

Default Combination of Attributes

 

By default, attributes are applied (or removed) cumulatively.

 

This means that if you set the current week to be bold and the current day to be italic, then the date in the mini-calendar that correspond to the current date will be bold and italic.

 

This default behavior can be changed as described in the overriding the default combination of attributes section below.

 

Overriding the Default Behavior

 

Overriding the Default Sequence

 

 

If you wish to override the default sequence in which mini-calendar dates are formatted, then you can use the mini-calendar Date Formatting Sequence Editor, located near the bottom of the mini-calendar Options dialog, and shown above.

 

Clicking on the ... (ellipsis) button opens a dialog in which you can change the order in which the special formatting applied to the @ date markers of a mini-calendar depending on various circumstances.

 

Clicking on the x button, either in the dialog on the left, or in the ButtonEdit control above, will reset the current sequence to the default sequence described at the top of the present topic.

 

With Append Cumulatively, each applicable group contributes its selected attributes in the configured sequence. Attributes affecting different properties combine. If two groups set the same property, the later group’s setting takes precedence.

 

To understand how all the mini-calendar options are combined, you can use the preview, but it is important to remember that the mini-calendar preview only shows the attributes that it will add to the existing text in the mini-calendar token. When previewing a mini-calendar, Q++Studio does not know what the fonts of the text in that text box is.

 

Overriding the Default Combination of Attributes

 

As mentioned above, by default, attributes are applied (or removed) cumulatively.

 

Use the Behavior settings of the text attributes editor dialog to override the default manner in which different attributes are applied to mini-calendar dates.

 

•For example, If you wish for the text attributes of a specific set of options to override all others, in the text attributes editor dialog, select the Ignore All Other Options behavior.

•Alternatively, if you wish for the text attributes of a specific set of options to override all previous ones, but to keep on having subsequent ones cumulatively added, in the text attributes editor dialog, select the Reset All Options behavior.

 

The following examples assume Append Cumulatively and the stated order:

 

•Current Week blue followed by Current Day red produces red dates.

•Holidays 1 red followed by Outside Days shade 30%, with no color change selected in Outside Days, produces dates in red at 30% shade.

 

The show only on current day and show only on holidays modifiers, used alone as :cd, :Hol1 or :Hol2, display only matching dates with the formatting those dates would normally receive. Adding -alt1 or -alt2 uses the corresponding Alternate Format instead of all other preceding and subsequent formatting. The :NoCD and :NoHol, :NoHol1 and :NoHol2 modifiers hide matching dates and require no alternate format.

 

See also: Current or Other mini-calendars.

 


Topic 181360, last updated on 01-Oct-2025