Property of the ScriptLine : DiaryGridLines.
Slogans are texts that are inserted into Slogan Tokens according to the structure of the corresponding Slogans Set. These Slogans Sets can be cyclical (run through the list of Slogans and repeat when done), Month and Day (every year on certain dates, which is similar to "Repeating Dates") or Specific Dates (which is similar to Specific Dates).
The Slogan Rules property editor adds further options as to the treatment of Slogan Tokens.
At the bottom left, is a list of the Slogan Tokens contained in the current GridTemplate and the Slogans Set associated with each Slogan Token.
•Q++ automatically fills-in the list of Slogan Tokens contained in the GridTemplate. These Slogan Tokens are of the form [:slog1] to [:slog15].
•To modify the rule for one of the Slogan Tokens, select it, modify the options at the top left and/or the associated Slogans Set, and then click on the APPLY button.
•To dissociate any Slogans Set from the current Slogans Token, select the Q++ root node.
On the right is the list of all the Slogans Sets. When you change the selection in the list of Slogan Tokens, the corresponding Slogans Set will be selected. If no Slogans Set is associated with the current Slogan Token, the Q++ root node will be selected.
At the top left are various options relating to the current Slogan Token. The first one, Skip Slogan, tells Q++ to skip (ie. not insert) a Slogan on dates when there is a Holiday for any of the selected Holidays Lists :
•Note this is triggered only by the date, and that this feature will work even if the Slogan Token and Holidays Token are in different textboxes, or even if there are no Holidays Tokens anywhere in the GridTemplate.
•The manner in which this "skipping" is done depends on the type of Slogans Set. In the case of "Run Once Only" or "Cyclical", no Slogan appears and the next Slogan in the list is used the next time (ie. none of the Slogans is skipped, they just do not appear on that date). In the case of "Month and Day" or "Specific Dates" the Slogan that was to appear on that date, if any, does not appear at all (not even later).
Finally the Start Cycle at Date or Index option is used to control the starting point of the replacement of the Slogan Tokens. The implementation of this option also depends on the type of Slogans Set.
•If the associated Slogans Set is "Run Once Only" or "Cyclical", and an index is chosen then will start from that index, the very first time the corresponding token is encountered. See "Selecting a Starting Index".
•If the associated Slogans Set is "Run Once Only" or "Cyclical", and a date is chosen then Q++ will ignore the corresponding token until its date is the selected date, and will then start with the Slogan of the smallest index.
•If the associated Slogans Set is "Month and Day" or "Specific Dates" , and a date is chosen then the corresponding Slogan Token will not be replaced on those dates.
Finally, some things are not possible :
•It is not possible to have Q++ start at an arbitrary index and at an arbitrary date. Only one of the 2 options can be selected.
•If you opt to have a "Run Only Once" Slogans Set start at a given index, it will run until the end of the list, and the Slogans previous to the starting index will never be used. Q++ will not go back to use just the ones before the starting index.
•If the associated Slogans Set is "Month and Day" or "Specific Dates" , then you cannot use an index for this option (it makes no sense, as indices are not defined for these types of Slogans Sets).