Changes between Version 90 and Version 91 of TaggingPresets


Ignore:
Timestamp:
2014-11-06T00:55:19+01:00 (11 years ago)
Author:
Klumbumbus
Comment:

joined "text"

Legend:

Unmodified
Added
Removed
Modified
  • TaggingPresets

    v90 v91  
    8888==== Attribute entry and selection dialog boxes ====
    8989 '''<text>'''::
    90    A text edit field to enter any arbitrary string from the user. ''key'' is mandatory, ''text'', ''default'', ''match'' and ''required'' is optional
     90   A text edit field to enter any arbitrary string from the user. ''key'' is mandatory, ''text'', ''default'', ''use_last_as_default'', ''auto_increment'', ''length'', ''alternative_autocomplete_keys'', ''match'' and ''required'' is optional
    9191 '''<combo>'''::
    9292   Displays a multiple choice combo box. ''key'' and ''values'' are mandatory and ''text'', ''default'', ''editable'', ''match'' and ''required'' is optional.
     
    122122   Translation context for text attribute to separate equals words with different meaning (not required for in-file translations).
    123123 '''default="default_value"'''::
    124    The default value for the item. If not specified, the current value of the key is chosen as default (if applicable). In case of <check> whether the checkbox is ticked on or off by default (default is "off").
     124   The default value for the item. If not specified, the current value of the key is chosen as default (if applicable). In case of <check> whether the checkbox is ticked on or off by default (default is "off"). In case of <text> defaults to "".
    125125 '''values="entry1,entry2,entry3"'''::
    126126   A list of entries (for the combo box and multiselect). The list has to be separated by commas (for the combo box) or by the specified delimiter (for the multiselect). If a value contains the delimiter, the delimiter may be escaped with a backslash. If a value contains a backslash, it must also be escaped with a backslash.
     
    139139 '''editable="false"'''::
    140140   The combo box is readonly, which means that the user can only select an item in the list.
    141  '''use_last_as_default="true"'''::
    142    For combo boxes or text fields the last value is used as default. Using "force" enforces this behaviour also for already tagged objects.
     141 '''use_last_as_default="true|false|force"'''::
     142   For combo boxes or text fields the last value is used as default. Using "force" enforces this behaviour also for already tagged objects. Default is "false".
    143143 '''rows="count"'''::
    144144   Specify the number of rows in multiselect entry.
     
    169169 '''preset_name_label="false|true"'''::
    170170   Whether to insert "[preset name]" label in dialog (defaults to "false" for backward-compatibility on external presets).
     171 '''length="a number"'''::
     172   The length of input box (number of characters allowed).
     173 '''alternative_autocomplete_keys="some_key(s)"'''::
     174   A comma separated list of alternative keys to use for autocompletion.
     175 '''auto_increment="-2,-1,+1,+2"'''::
     176   May contain a comma separated list of integer increments or decrements, e.g. "-2,-1,+1,+2". A button will be shown next to the text field for each value, allowing the user to select auto-increment with the given stepping. Auto-increment only happens if the user selects it. Default is no auto-increment. Mutually exclusive with use_last_as_default.
    171177
    172178== Format description from XML document (needs to be joined with above texts) ==
     
    174180
    175181{{{
    176 
    177 text: text box
    178   key: key to set
    179   text: fixed label to display
    180   default: default string to display (defaults to "")
    181   use_last_as_default: true/false/force (default is "false")
    182   auto_increment: may contain a comma separated list of integer increments or
    183                   decrements, e.g. "-2,-1,+1,+2"; a button will be shown next
    184                   to the text field for each value, allowing the user to select
    185                   auto-increment with the given stepping. auto-increment only
    186                   happens if the user selects it. default is no auto-increment;
    187                   mutually exclusive with use_last_as_default.
    188   length: length of input box (number of characters allowed)
    189   alternative_autocomplete_keys: comma separated list of alternative keys to use for autocompletion
    190182
    191183combo: combo box, with multiple choices and possible to enter free form text