Messages.AlternateMessage (GWT Javadoc)

Overview | Package | Class | Use | Deprecated | Help
| GWT 2.7.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: REQUIRED | OPTIONAL | DETAIL: ELEMENT

## com.google.gwt.i18n.client
Annotation Type Messages.AlternateMessage

    @Retention(value=RUNTIME)
    @Target(value=METHOD)
    @Documented
    public static @interface Messages.AlternateMessage

Provides alternate forms of a message, such as are needed when plural forms are used or a placeholder has known gender. The selection of which form to use is based on the value of the arguments marked PluralCount and/or Select.

Example: ``

       @DefaultMessage("You have {0} widgets.")
       @AlternateMessage({"one", "You have one widget.")
       String example(@PluralCount int count);

If multiple `Messages.PluralCount` or `Messages.Select` parameters are supplied, the forms for each, in the order they appear in the parameter list, are supplied separated by a vertical bar ("|"). Example: ``

       @DefaultMessage("You have {0} messages and {1} notifications.")
       @AlternateMessage({
           "=0|=0", "You have no messages or notifications."
           "=0|one", "You have a notification."
           "one|=0", "You have a message."
           "one|one", "You have one message and one notification."
           "other|one", "You have {0} messages and one notification."
           "one|other", "You have one message and {1} notifications."
       })
       String messages(@PluralCount int msgCount,
           @PluralCount int notifyCount);

Note that the number of permutations can grow quickly, and that the default message is used when every `Messages.PluralCount` or `Messages.Select` would use the "other" value.

Required Element Summary
`java.lang.String[]` | `value` An array of pairs of strings containing the strings for different forms.

Element Detail

### value

    public abstract java.lang.String[] value

  An array of pairs of strings containing the strings for different forms. Each pair is the name of a form followed by the string in the source locale for that form. Each form name is the name of a plural form if `Messages.PluralCount` is used, or the matching value if `Messages.Select` is used. An example for a locale that has "none", "one", and "other" plural forms: `

       @DefaultMessage("{0} widgets")
       @AlternateMessage({"none", "No widgets", "one", "One widget"})

  Note that the plural form "other" gets the translation specified in `&#64;DefaultMessage`, as does any `&#64;Select` value not listed. If more than one way of selecting a translation exists, they will be combined, separated with `|`, in the order they are supplied as arguments in the method. For example: `

         @DefaultMessage("{0} gave away their {2} widgets")
         @AlternateMesssage({
           "MALE|other", "{0} gave away his {2} widgets",
           "FEMALE|other", "{0} gave away her {2} widgets",
           "MALE|one", "{0} gave away his widget",
           "FEMALE|one", "{0} gave away her widget",
           "other|one", "{0} gave away their widget",
         })
         String giveAway(String name, @Select Gender gender,
             @PluralCount int count);

  `

  `

Overview | Package | Class | Use | Deprecated | Help
| GWT 2.7.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: REQUIRED | OPTIONAL | DETAIL: ELEMENT