Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
GObject
public class StatusBar
extends HBox
Window
. It may provide a regular commentary of the application's
status (as is usually the case in a web browser, for example), or may be used
to simply output a message when the status changes, (when an upload is
complete in an FTP client, for example). It may also have a resize grip (a
triangular area in the lower right corner) which can be clicked on to resize
the window containing the statusbar.
Status bars in Gtk+ maintain a stack of messages. The message at the top of
the each bar's stack is the one that will currently be displayed.
Any messages added to a statusbar's stack must specify a contextID that is
used to uniquely identify the source of a message. This contextID can be
generated by getContextID(String)
, given a message. Note that
messages are stored in a stack, and when choosing which message to display,
the stack structure is adhered to, regardless of the context identifier of a
message.
Messages are added to the bar's stack with push(int,String)
.
The message at the top of the stack can be removed using pop(int)
.
A message can be removed from anywhere in the stack if it's messageID was
recorded at the time it was added. This is done using remove(int,int)
.
Constructor Summary | |
| |
|
Method Summary | |
void |
|
int |
|
Class |
|
EventType |
|
boolean |
|
static StatusBar |
|
static Type |
|
void |
|
int |
|
void |
|
void |
|
void |
|
Methods inherited from class org.gnu.gtk.Box | |
getHomogeneous , getSpacing , getType , packEnd , packEnd , packStart , packStart , reorderChild , setHomogeneous , setSpacing |
Methods inherited from class org.gnu.gtk.Container | |
add , addListener , getBooleanChildProperty , getBorderWidth , getChildProperty , getChildren , getEventListenerClass , getEventType , getIntChildProperty , getResizeMode , getType , remove , removeListener , resizeChildren , setBooleanChildProperty , setBorderWidth , setChildProperty , setIntChildProperty , setResizeMode |
public StatusBar()
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Creates a new StatusBar Widget
public StatusBar(Handle handle)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Creates a new StatusBar from a handle to native resources. This should only be used internally by the Java-Gnome packages.
public void addListener(StatusBarListener listener)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Register an object to handle StatusBar events.
- See Also:
StatusBarListener
public int getContextID(String description)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns a new context identifier, given a description of the actual context.
- Parameters:
description
- textual description of what context the new message is being used in.
- See Also:
StatusBar
public Class getEventListenerClass(String signal)
- Overrides:
- getEventListenerClass in interface Container
public EventType getEventType(String signal)
- Overrides:
- getEventType in interface Container
public boolean getHasResizeGrip()
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns whether the statusbar has a resize grip.
- Returns:
- TRUE if the statusbar has a resize grip.
public static StatusBar getStatusBar(Handle handle)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Internal static factory method to be used by Java-Gnome only.
public static Type getType()
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Retrieve the runtime type used by the GLib library.
public void pop(int contextID)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Removes the message at the top of the statusbar's stack.
- Parameters:
contextID
- a context identifier.
public int push(int contextID, String text)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Pushes a new message onto a statusbar's stack.
- Parameters:
contextID
- The message's context id, as returned bygetContextID(String)
text
- The message to add to the statusbar.
- Returns:
- The message's new message id for use with
remove(int,int)
public void remove(int contextID, int messageID)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Forces the removal of a message from a statusbar's stack. The exact contextID and messageID must be specified.
- Parameters:
contextID
- A context identifier.messageID
- A message identifier, as returned bypush(int,String)
.
public void removeListener(StatusBarListener listener)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Removes a listener
- See Also:
addListener(StatusBarListener)
public void setHasResizeGrip(boolean setting)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Sets whether the statusbar has a resize grip. TRUE by default.
- Parameters:
setting
- TRUE to have a resize grip.