Holiday Abbreviation Display Options ([fâ]..[fû] tokens)

Navigation:  ScriptLine Properties > Holidays (display) >

Holiday Abbreviation Display Options ([fâ]..[fû] tokens)

Previous pageReturn to chapter overviewNext page

The Holiday Abbreviation options allow you to specify how the result of the [fâ]..[fû] holidays abbreviations tokens are displayed.

 

By default, the Holiday Abbreviations display options assume that the value of the holidays abbreviations, as specified in the holidays manager, is made up of one or more abbreviation, separated from one another by a single space. The length of each sub-abbreviation, and the characters its contains, are not important, what matters is that each be separated from the others by a single space.

 

Separators

 

If the separator field is not blank, then the separator character(s) will be inserted between each individual character of the associated symbols fields of holidays abbreviations and one-time-dates.

 

You can use special characters tokens to insert tabs and carriage returns.

These separators will also be used to separate individual abbreviations, in the event of multiple recurring holidays or one-time-dates occurring on the same date.

 

Sorting and Filtering

 

The sorting options are used to sort and/or filter the holidays abbreviations produced from the holidays abbreviations tokens.

 

None

The result of the holiday abbreviation token conversion are not sorted.

 

The abbreviations are left in the order in which the holidays sets appear in the token's corresponding aeiou-holidays, and then, within the same set, they appear in the order in which they are listed for each individual holiday in the holidays manager. If there are 2 holidays of the same set on the same date, then the order is based on the relative priority of the 2 holidays or one-time-dates.

Alphabetically

The result of the holiday abbreviation token conversion are broken up into sub-abbreviations (assuming they are all separated by a space) and sorted alphabetically.

 

If some of the entries are made up of more than one word, but that they should not be broken-up in the process of sorting, then you should replace the normal spaces within an individual entry by either an underscore "_" or a tilde "~"; any underscore character "_" (without the quotes) contained in this string will be replaced by a non-breaking space and that a tilde character "~" (without the quotes) contained in this string will be replaced by a normal space.

No Duplicates (not sorted)

Removes duplicates, but without sorting the abbreviations, which are then left in the order in which the holidays sets are listed in the aeiou-holidays property of the current script.

Use Filter Below

Filters the result of the [fâ]..[fû] tokens conversion, to match the order and selection of abbreviations specified in the ButtonEdit below.

 

The Filter option is extremely powerful, because it allows you to make a single master list of holidays abbreviations, one possibly containing holidays from over a hundred countries, and have the abbreviations that appear be dependent on the script, not the holidays set.

 

Suppose, for example, we had a single, master, holidays set that contained the abbreviations to holidays for 120 different countries. Using the filter below left, we could ensure that only the abbreviations for the US, Canada and the UK appeared when an [fâ] token is found in the current script. Using the filter, below right, and the same master Holidays Set, we could have another script that only displays the abbreviations of Belgium, France and the Netherlands.

 

           

 

What's more, the filters also act as sorters. If we wanted the diaries above to display abbreviations in a different, customized, order, all we would need to do is to change the filters:

 

           

 

Note that the above 4 different ways of displaying abbreviations were accomplished using a single master Holidays Set, with no need to specify each holiday priority.

 

Do not split individual holidays' abbreviations

 

This option is used if you are using the abbreviation field of holidays to display country names rather that abbreviations, such as in the example on the right. In that case, a that country name, as well as Hong Kong or United States would be treated as 2 multiples abbreviations and lead to strange results, as shown below.

 

In such cases, when the abbreviations of a holidays set contain country names rather than country abbreviations, check the Do not split individual holidays' abbreviations option to ensure that each entry in the abbreviation field is kept whole.

 

 

Layout options

 

The Layout options can be used to better format the series of abbreviations, particularly when there are more than can fit on a single line.

These options are:

 

Break equally if too long

This option will break the series of abbreviations into 2 roughly equal sub-strings, if the string is too long to fit on a single line, and leaves orphaned abbreviations on the second line. This helps avoid unsightly results such as the first below, and instead produces results such as the second one below (the examples below use symbols instead of abbreviations, but the principle is the same).

 

 

 

Note that to compensate for the width of the word Holiday, the above example uses an Offset value of 8, which tells Q++Studio that there is some text before the string of abbreviations, and that this text is 8 characters long. note here that the value used is the number of individual characters, and not the number of abbreviations.

Break after max char number

This option can be used to specify that a line of abbreviations should never contain more than a given number of characters (not the number of abbreviations), as specified by the value of Max char. The examples below use symbols instead of abbreviations, but the principle is the same.

 

         

 

Additionally, the setting Orph.bot. lets you specify if the partial (orphaned) lines should be at the top (see example above left) or the bottom (example above right).

 

See also: holidays symbols display options.


Topic 173210 updated on 13-Apr-2019.
Topic URL: https://www.qppstudio.net/webhelp_xe3/index.html?holidayabbreviationtokens.htm