API java : Action

javax.swing
Interface Action

All Superinterfaces:: ActionListener, EventListener

All Known Implementing Classes:: AbstractAction, BasicDesktopPaneUI.CloseAction, BasicDesktopPaneUI.MaximizeAction, BasicDesktopPaneUI.MinimizeAction, BasicDesktopPaneUI.NavigateAction, BasicDesktopPaneUI.OpenAction, BasicFileChooserUI.ApproveSelectionAction, BasicFileChooserUI.CancelSelectionAction, BasicFileChooserUI.ChangeToParentDirectoryAction, BasicFileChooserUI.GoHomeAction, BasicFileChooserUI.NewFolderAction, BasicFileChooserUI.UpdateAction, BasicInternalFrameTitlePane.CloseAction, BasicInternalFrameTitlePane.IconifyAction, BasicInternalFrameTitlePane.MaximizeAction, BasicInternalFrameTitlePane.MoveAction, BasicInternalFrameTitlePane.RestoreAction, BasicInternalFrameTitlePane.SizeAction, BasicSliderUI.ActionScroller, BasicTreeUI.TreeCancelEditingAction, BasicTreeUI.TreeHomeAction, BasicTreeUI.TreeIncrementAction, BasicTreeUI.TreePageAction, BasicTreeUI.TreeToggleAction, BasicTreeUI.TreeTraverseAction, DefaultEditorKit.BeepAction, DefaultEditorKit.CopyAction, DefaultEditorKit.CutAction, DefaultEditorKit.DefaultKeyTypedAction, DefaultEditorKit.InsertBreakAction, DefaultEditorKit.InsertContentAction, DefaultEditorKit.InsertTabAction, DefaultEditorKit.PasteAction, HTMLEditorKit.HTMLTextAction, HTMLEditorKit.InsertHTMLTextAction, MetalFileChooserUI.DirectoryComboBoxAction, StyledEditorKit.AlignmentAction, StyledEditorKit.BoldAction, StyledEditorKit.FontFamilyAction, StyledEditorKit.FontSizeAction, StyledEditorKit.ForegroundAction, StyledEditorKit.ItalicAction, StyledEditorKit.StyledTextAction, StyledEditorKit.UnderlineAction, TextAction

public interface Action
extends ActionListener
extends ActionListener

The Action interface provides a useful extension to the ActionListener interface in cases where the same functionality may be accessed by several controls.

In addition to the actionPerformed method defined by the ActionListener interface, this interface allows the application to define, in a single place:

One or more text strings that describe the function. These strings can be used, for example, to display the flyover text for a button or to set the text in a menu item.
One or more icons that depict the function. These icons can be used for the images in a menu control, or for composite entries in a more sophisticated user interface.
The enabled/disabled state of the functionality. Instead of having to separately disable the menu item and the toolbar button, the application can disable the function that implements this interface. All components which are registered as listeners for the state change then know to disable event generation for that item and to modify the display accordingly.

Certain containers, including menus and tool bars, know how to add an Action object. When an Action object is added to such a container, the container:

Creates a component that is appropriate for that container (a tool bar creates a button component, for example).
Gets the appropriate property(s) from the Action object to customize the component (for example, the icon image and flyover text).
Checks the initial state of the Action object to determine if it is enabled or disabled, and renders the component in the appropriate fashion.
Registers a listener with the Action object so that is notified of state changes. When the Action object changes from enabled to disabled, or back, the container makes the appropriate revisions to the event-generation mechanisms and renders the component accordingly.

For example, both a menu item and a toolbar button could access a Cut action object. The text associated with the object is specified as "Cut", and an image depicting a pair of scissors is specified as its icon. The Cut action-object can then be added to a menu and to a tool bar. Each container does the appropriate things with the object, and invokes its actionPerformed method when the component associated with it is activated. The application can then disable or enable the application object without worrying about what user-interface components are connected to it.

This interface can be added to an existing class or used to create an adapter (typically, by subclassing AbstractAction). The Action object can then be added to multiple Action-aware containers and connected to Action-capable components. The GUI controls can then be activated or deactivated all at once by invoking the Action object's setEnabled method.

Note that Action implementations tend to be more expensive in terms of storage than a typical ActionListener, which does not offer the benefits of centralized control of functionality and broadcast of property changes. For this reason, you should take care to only use Actions where their benefits are desired, and use simple ActionListeners elsewhere.

See Also:: AbstractAction

Field Summary

static String ACCELERATOR_KEY
          The key used for storing a KeyStroke to be used as the accelerator for the action.

static String ACTION_COMMAND_KEY
          The key used to determine the command String for the ActionEvent that will be created when an Action is going to be notified as the result of residing in a Keymap associated with a JComponent.

static String DEFAULT
          Not currently used.

static String LONG_DESCRIPTION
          The key used for storing a longer String description for the action, could be used for context-sensitive help.

static String MNEMONIC_KEY
          The key used for storing a KeyEvent to be used as the mnemonic for the action.

static String NAME
          The key used for storing the String name for the action, used for a menu or button.

static String SHORT_DESCRIPTION
          The key used for storing a short String description for the action, used for tooltip text.

static String SMALL_ICON
          The key used for storing a small Icon, such as ImageIcon, for the action, used for toolbar buttons.

Method Summary

void addPropertyChangeListener(PropertyChangeListener listener)
          Adds a PropertyChange listener.

Object getValue(String key)
          Gets one of this object's properties using the associated key.

boolean isEnabled()
          Returns the enabled state of the Action.

void putValue(String key, Object value)
          Sets one of this object's properties using the associated key.

void removePropertyChangeListener(PropertyChangeListener listener)
          Removes a PropertyChange listener.

void setEnabled(boolean b)
          Sets the enabled state of the Action.

Methods inherited from interface java.awt.event.ActionListener

actionPerformed

Field Summary
`static String`	`ACCELERATOR_KEY` The key used for storing a `KeyStroke` to be used as the accelerator for the action.
`static String`	`ACTION_COMMAND_KEY` The key used to determine the command `String` for the `ActionEvent` that will be created when an `Action` is going to be notified as the result of residing in a `Keymap` associated with a `JComponent`.
`static String`	`DEFAULT` Not currently used.
`static String`	`LONG_DESCRIPTION` The key used for storing a longer `String` description for the action, could be used for context-sensitive help.
`static String`	`MNEMONIC_KEY` The key used for storing a `KeyEvent` to be used as the mnemonic for the action.
`static String`	`NAME` The key used for storing the `String` name for the action, used for a menu or button.
`static String`	`SHORT_DESCRIPTION` The key used for storing a short `String` description for the action, used for tooltip text.
`static String`	`SMALL_ICON` The key used for storing a small `Icon`, such as `ImageIcon`, for the action, used for toolbar buttons.

Method Summary
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` Adds a `PropertyChange` listener.
`Object`	`getValue(String key)` Gets one of this object's properties using the associated key.
`boolean`	`isEnabled()` Returns the enabled state of the `Action`.
`void`	`putValue(String key, Object value)` Sets one of this object's properties using the associated key.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` Removes a `PropertyChange` listener.
`void`	`setEnabled(boolean b)` Sets the enabled state of the `Action`.

Methods inherited from interface java.awt.event.ActionListener
`actionPerformed`

Field Detail

DEFAULT

static final String DEFAULT

Not currently used.

See Also:: Constant Field Values

NAME

static final String NAME

The key used for storing the String name for the action, used for a menu or button.

See Also:: Constant Field Values

SHORT_DESCRIPTION

static final String SHORT_DESCRIPTION

The key used for storing a short String description for the action, used for tooltip text.

See Also:: Constant Field Values

LONG_DESCRIPTION

static final String LONG_DESCRIPTION

The key used for storing a longer String description for the action, could be used for context-sensitive help.

See Also:: Constant Field Values

SMALL_ICON

static final String SMALL_ICON

The key used for storing a small Icon, such as ImageIcon, for the action, used for toolbar buttons.

See Also:: Constant Field Values

ACTION_COMMAND_KEY

static final String ACTION_COMMAND_KEY

The key used to determine the command String for the ActionEvent that will be created when an Action is going to be notified as the result of residing in a Keymap associated with a JComponent.

See Also:: Constant Field Values

ACCELERATOR_KEY

static final String ACCELERATOR_KEY

The key used for storing a KeyStroke to be used as the accelerator for the action.

Since:: 1.3
See Also:: Constant Field Values

MNEMONIC_KEY

static final String MNEMONIC_KEY

The key used for storing a KeyEvent to be used as the mnemonic for the action.

Since:: 1.3
See Also:: Constant Field Values

Method Detail

getValue

Object getValue(String key)

Gets one of this object's properties using the associated key.

See Also:: putValue(java.lang.String, java.lang.Object)

putValue

void putValue(String key,
              Object value)

Sets one of this object's properties using the associated key. If the value has changed, a PropertyChangeEvent is sent to listeners.

Parameters:: key - a String containing the key; value - an Object value

setEnabled

void setEnabled(boolean b)

Sets the enabled state of the Action. When enabled, any component associated with this object is active and able to fire this object's actionPerformed method. If the value has changed, a PropertyChangeEvent is sent to listeners.

Parameters:: b - true to enable this Action, false to disable it

isEnabled

boolean isEnabled()

Returns the enabled state of the Action. When enabled, any component associated with this object is active and able to fire this object's actionPerformed method.

Returns:: true if this Action is enabled

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener listener)

Adds a PropertyChange listener. Containers and attached components use these methods to register interest in this Action object. When its enabled state or other property changes, the registered listeners are informed of the change.

Parameters:: listener - a PropertyChangeListener object

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener listener)

Removes a PropertyChange listener.

Parameters:: listener - a PropertyChangeListener object
See Also:: addPropertyChangeListener(java.beans.PropertyChangeListener)

Package :

Ces informations proviennent du site de http://java.sun.com

Remarques

Contenu

Le contenu de cette page provient du site de Sun, et est généré depuis un cache sur l'infobrol après certains traitements automatisés. La présentation peut donc différer du document original, mais le contenu aussi. Vous pouvez utiliser ce bouton pour afficher la page originale du site de Sun :

Quels sont les motivations de cette démarche?

Maintenir les pages en cache sur différents sites peut offrir plus de disponibilité.

Chaque page est indexée dans la base de donnée, ce qui permet de retrouver facilement les informations, au moyen des sommaires, du moteur de recherche interne, etc.

Des facilités sont mises en place pour que les membres de l'infobrol puissent effectuer des traductions en français des différents documents. Ceci devrait permettre aux débutants en programmation Java de consulter les API en français s'ils maîtrisent moins bien la langue de Shakespeare. Dans le cas où une traduction a été soumise, elle est disponible au moyen d'un lien en bas de page. Si la traduction a été validée, la page s'affiche par défaut en français, et un lien en bas de page permet d'atteindre la version en anglais.

Le code sur l'infobrol est automatiquement coloré selon la syntaxe, et les différents mots clés sont transformés en liens pour accéder rapidement aux informations.

Vous avez la possibilité de partager vos expériences en proposant vos propres extraits de code en utilisant le bouton "ajouter un commentaire" en bas de page. Si vous visitez simplement l'infobrol, vous avez déjà accès à cette fonction, mais si vous étes membre du brol, vous pouvez en plus utiliser des boutons supplémentaires de mise en forme, dont la coloration automatique de vos extraits de codes.

<- AclNotFoundException ActionEvent ->

Réseaux sociaux

|Plus d'options...

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

Nuage de mots clés

6 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

Structure du document

Réseaux sociaux
Nuage de mots clés
- Avertissement :

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html

Aucun commentaire pour cette page

tection. Enregistrement IDDN n° 5329-1168
Document créé le 29/08/06 02:29, dernière modification le Vendredi 17 Juin 2011, 12:12
Source du document imprimé : http://www.gaudry.be/java-api-rf-javax/swing/Action.html Document affiché 1 fois ce mois de Juin.
St.Gaudry©07.01.02