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 fine-tune the way the result of the [fâ]..[fû] tokens is displayed. These options assume that the value of the Holidays Abbreviations, as specified in the Holidays Manager, is made up of sub-abbreviations, each separated 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. The options are :

 

 

Separator : If this field is not blank, then Q++ will replace all spaces found in the abbreviation fields of recurring holidays and one-time-dates by the text you have defined as separator. Note that :

 

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 : Use this option to tell Q++ if the abbreviations should be sorted and/or filtered. The 3 sorting options are :

 

None

The result of the holiday abbreviation token conversion are not sorted (they are left in the order in which they appear in the Holidays Manager), but if the value of the separator above is not blank, then each abbreviation is separated using the text contained in separator.

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.


Note that the sort order used here is based on the regional settings of Windows on your PC. In most cases this will not matter, but if you have some abbreviations starting with letters such as Å Æ Ø you must make sure that Windows is setup to sort these characters as you want them to be sorted. If the value of the separator above is not blank, then each abbreviation is also separated using the text contained in separator.


Also, 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. See the topics on non-breaking spaces and normal spaces, to determine under which conditions each of these should be used.

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 Switzerland.

 

           

 

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 holidays names rather that abbreviations, such as in the example below:

 

 

In that case, a country name such as "Hong Kong" or "United States" would be treated as 2 individual abbreviations and lead to strange results.

 

 

In these cases, check this option to ensure that each entry in the abbreviation field is kept whole (see output below).

 

 

The Layout option 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 substrings, 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++ 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 12-Feb-2007.
Topic URL: http://www.qppstudio.net/webhelp/index.html?holidayabbreviationtokens.htm