org.gnu.gtk
public class Button extends Bin
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. |
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
Button myButton = new Button( new StockItem( StockItem.NO );
)
Parameters: stockItem A gtk stock item
See Also: GtkStockItem
Button myButton = new Button( StockItem.NO;
)
Parameters: stockItem A String representing a stock item
See Also: GtkStockItem
See Also: ButtonListener
See Also: addListener
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