Package org.eclipse.jface.menus

Class TextState

java.lang.Object

org.eclipse.core.commands.common.EventManager

org.eclipse.core.commands.State

org.eclipse.jface.commands.PersistentState

org.eclipse.jface.menus.TextState

public class TextState
extends PersistentState

A piece of state carrying a single String.

If this state is registered using INamedHandleStateIds.NAME or INamedHandleStateIds.DESCRIPTION, then this allows the handler to communicate a textual change for a given command. This is typically used by graphical applications to allow more specific text to be displayed in the menus. For example, "Undo" might become "Undo Typing" through the use of a TextState.

Clients may instantiate this class, but must not extend.

Since:

3.2

See Also:

INamedHandleStateIds

Constructor Summary

Constructors

Constructor	Description
TextState()

Method Summary

Modifier and Type	Method	Description
void	load(IPreferenceStore store, String preferenceKey)	Loads this state from the preference store, given the location at which to look.
void	save(IPreferenceStore store, String preferenceKey)	Saves this state to the preference store, given the location at which to write.
void	setValue(Object value)	Sets the value for this state object.

Methods inherited from class org.eclipse.jface.commands.PersistentState

setShouldPersist, shouldPersist

Methods inherited from class org.eclipse.core.commands.State

addListener, dispose, fireStateChanged, getId, getValue, removeListener, setId

Methods inherited from class org.eclipse.core.commands.common.EventManager

addListenerObject, clearListeners, getListeners, isListenerAttached, removeListenerObject

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TextState

public TextState()

Method Detail

load

public final void load(IPreferenceStore store,
                       String preferenceKey)

Description copied from class: PersistentState

Loads this state from the preference store, given the location at which to look. This method must be symmetric with a call to PersistentState.save(IPreferenceStore, String).

Specified by:

load in class PersistentState

Parameters:

store - The store from which to read; must not be null.

preferenceKey - The key at which the state is stored; must not be null.

save

public final void save(IPreferenceStore store,
                       String preferenceKey)

Description copied from class: PersistentState

Saves this state to the preference store, given the location at which to write. This method must be symmetric with a call to PersistentState.load(IPreferenceStore, String).

Specified by:

save in class PersistentState

Parameters:

store - The store to which the state should be written; must not be null.

preferenceKey - The key at which the state should be stored; must not be null.

setValue

public void setValue(Object value)

Description copied from class: State

Sets the value for this state object.

Overrides:

setValue in class State

Parameters:

value - The value to set; may be anything.