Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4730476

Action.DEFAULT is not documented (or used?)

XMLWordPrintable

    • x86
    • linux, windows_2000



      Name: jk109818 Date: 08/12/2002


      FULL PRODUCT VERSION :
      java version "1.4.0"
      Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
      Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)

      FULL OPERATING SYSTEM VERSION :

      Microsoft Windows 2000 [Version 5.00.2195]


      A DESCRIPTION OF THE PROBLEM :
      The documentation for javax.swing.Action.DEFAULT says:

      Useful constants that can be used as the storage-retrieval
      key when setting or getting one of this object's properties
      (text or icon).

      But, what does this mean? When would I want to use the
      Action.DEFAULT key instead of Action.NAME or
      Action.SMALL_ICON? Is Action.DEFAULT even used by the Swing
      components?

      I looked at the source code for AbstractButton and JButton
      and they don't seem to use Action.DEFAULT. I did the
      following two searches through the source code and found
      that the key seems not to be used at all by any Swing
      components:

      find . -path */javax/swing/* -name *.java | xargs grep
      \"Default\"

      find . -path */javax/swing/* -name *.java | xargs
       grep DEFAULT | grep -v DEFAULT_

      More documentation about this key would be helpful.
      Especially, what are the expected values supposed to be?
      Perhaps you can provide an example?

      This bug can be reproduced always.
      (Review ID: 146065)
      ======================================================================

      Name: rmT116609 Date: 10/22/2002


      EXPECTED VERSUS ACTUAL BEHAVIOR :
      I expected the field description to explain what the key DEFAULT is used for
      (as the field description for NAME says "The key used for storing the name for the action...").

      (Review ID: 165989)
      ======================================================================

            svioletsunw Scott Violet (Inactive)
            jkimsunw Jeffrey Kim (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: