org.gnu.gtk
public class Button extends Bin
Deprecated: This class is part of the java-gnome 2.x family of libraries,
which, due to their inefficiency and complexity, are no longer
being maintained and have been abandoned by the java-gnome
project. This class may in the future have an equivalent in
java-gnome 4.0, try looking for
org.gnome.gtk.Button
.
You should be aware that there is a considerably different API
in the new library: the architecture is completely different
and most notably internals are no longer exposed to public view.
The gtk.Button widget can hold any valid child widget. That is it can hold most any other standard gtk.Widget. The most commonly used child is the gtk.Label.
Constructor Summary | |
---|---|
Button()
Creates a new Button widget | |
Button(String label, boolean hasMnemonic)
Creates a button widget with a gtk.Label child containing the given text.
| |
Button(GtkStockItem stockItem)
Constructs a button using a stock item. | |
Button(String stockItem)
Constructs a button using a String that represents a stock item. | |
Button(Handle handle)
Construct a button using a handle to a native resource. |
Method Summary | |
---|---|
void | addListener(ButtonListener listener)
Register an object to handle button events.
|
void | click()
Sends a clicked signal to the button. |
void | enter()
Sends an enter signal to the button. |
static Button | getButton(Handle handle)
Construct a button using a handle to a native resource. |
Class | getEventListenerClass(String signal) |
EventType | getEventType(String signal) |
boolean | getFocusOnClick() |
Widget | getImage() |
String | getLabel()
Returns the label which is being used on the button. |
ReliefStyle | getRelief()
Returns the current relief style of the button |
static Type | getType()
Retrieve the runtime type used by the GLib library. |
boolean | getUseStock()
Returns true if this button is using stock items |
boolean | getUseUnderline()
Returns whether an embedded underline in the button label indicates a
mnemonic. |
double | getXAlignment() |
double | getYAlignment() |
void | leave()
Sends a leave signal to the button. |
void | press()
Sends a pressed signal to the button. |
void | release()
Sends a released signal to the button. |
void | removeListener(ButtonListener listener)
Removes a listener
|
void | setAlignment(double xalign, double yalign) |
void | setFocusOnClick(boolean focusOnClick) |
void | setImage(Widget image) |
void | setLabel(String newLabel)
Sets the text of the label of the button to newLabel. |
void | setRelief(ReliefStyle newRelief)
Sets the relief style of the edges of the Button widget. |
void | setUseStock(boolean useStock)
Setting this will true will make the widget try to interpret the label as
a stock item. |
void | setUseUnderline(boolean useUnderLine)
If true, an underline in the text of the button label indicates the next
character should be used for the mnemonic accelerator key. |
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 Button widgetDeprecated: 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 button widget with a gtk.Label child containing the given text.
If hasMnemonic
is true, the label will be interpreted as
containing Mnemonic characters (keyboard accelerators). If
characters in label are proceeded by an underscore character, they will
be underlined. The first underlined character will be taken as the
mnemonic - pressing Alt
and that character will activate
the button.
Parameters: label Text to appear on the button hasMnemonic See above 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.
Constructs a button using a stock item. Stock items are standard icons and text strings. The use of these is highly encouraged as they allow gtk themes to have greater control over applications and so give a more consistent interface to the user.Button myButton = new Button( new StockItem( StockItem.NO );
)
Parameters: stockItem A gtk stock item
See Also: GtkStockItem
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.
Constructs a button using a String that represents a stock item. Stock items are standard icons and text strings. The use of these is highly encouraged as they allow gtk themes to have greater control over applications and so give a more consistent interface to the user.Button myButton = new Button( StockItem.NO;
)
Parameters: stockItem A String representing a stock item
See Also: GtkStockItem
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.
Construct a button using a handle to a native resource.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 button events.See Also: ButtonListener
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.
Sends a clicked signal to the button. If handlers have been set up for this event, they will be calledDeprecated: 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.
Sends an enter signal to the button. If handlers have been set up for this event, they will be called.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.
Construct a button using a handle to a native resource.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 the label which is being used on the button.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 the current relief style of the buttonDeprecated: Superceeded by java-gnome 4.0.
Retrieve the runtime type used by the GLib library.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 true if this button is using stock itemsDeprecated: 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 an embedded underline in the button label indicates a mnemonic.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.
Sends a leave signal to the button. If handlers have been set up for this event, they will be called.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.
Sends a pressed signal to the button. If handlers have been set up for this event then they will be calledDeprecated: 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.
Sends a released signal to the button. If handlers have been set up for this event, they will be called.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 listenerSee Also: addListener
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 the text of the label of the button to newLabel. If setUseStock has been called or this object was created using stock buttons, then newLabel should be the name of the stock item to be used.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 the relief style of the edges of the Button widget.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.
Setting this will true will make the widget try to interpret the label as a stock item. If the stock id is unknown, it will be treated as a normal label.Stock items are standard icons and strings. These are included in Gtk themes, so that the appearance of all applications follows their theme. The use of stock items is highly recommended.
Parameters: useStock true if this button should use stock items
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.
If true, an underline in the text of the button label indicates the next character should be used for the mnemonic accelerator key.