|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.gnu.glib.Struct
org.gnu.glib.GObject
org.gnu.gtk.GtkObject
org.gnu.gtk.Widget
org.gnu.gtk.Container
org.gnu.gtk.Bin
org.gnu.gtk.Window
org.gnu.gtk.Dialog
org.gnome.gtk.Dialog
.
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.
public class Dialog
Dialog boxes are a convenient way to prompt the user for a small amount of input, to display a message, ask a question, or anything else that does not require extensive effort on the user's part.
GTK+ treats a dialog as a window split vertically. The top section is a
VBox
, and is where widgets such as a Label
or a
Entry
should be packed. The bottom area is known as the
actionArea. This is generally used for packing buttons into the
dialog which may perform functions such as cancel, ok, or apply. The two
areas are separated by a HSeparator
.
A 'modal' dialog (that is, one which freezes the rest of the application from
user input), can be created by calling Window.setModal(boolean)
on
the dialog.
If you want to block waiting for a dialog to return before returning control
flow to your code, you can call run()
. This function enters a
recursive main loop and waits for the user to respond to the dialog,
returning the response ID corresponding to the button the user clicked.
Constructor Summary | |
---|---|
Dialog()
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. |
|
Dialog(org.gnu.glib.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. |
Method Summary | |
---|---|
void |
addButton(GtkStockItem stockItem,
int responseId)
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. |
void |
addButton(java.lang.String buttonText,
int responseId)
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. |
void |
addListener(DialogListener 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. |
void |
addWidget(Widget child,
int responseId)
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. |
HButtonBox |
getActionArea()
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. |
static Dialog |
getDialog(org.gnu.glib.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. |
VBox |
getDialogLayout()
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. |
java.lang.Class |
getEventListenerClass(java.lang.String signal)
Deprecated. |
org.gnu.glib.EventType |
getEventType(java.lang.String signal)
Deprecated. |
boolean |
getHasSeparator()
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. |
ResponseType |
getResponseForWidget(Widget 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. |
static org.gnu.glib.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. |
void |
removeListener(DialogListener 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. |
int |
run()
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. |
void |
setDefaultResponse(int responseId)
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. |
void |
setHasSeparator(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. |
Methods inherited from class org.gnu.gtk.Bin |
---|
getChild |
Methods inherited from class org.gnu.gtk.Container |
---|
add, addListener, getBooleanChildProperty, getBorderWidth, getChildProperty, getChildren, getIntChildProperty, getResizeMode, remove, removeListener, resizeChildren, setBooleanChildProperty, setBorderWidth, setChildProperty, setIntChildProperty, setResizeMode |
Methods inherited from class org.gnu.gtk.GtkObject |
---|
sink |
Methods inherited from class org.gnu.glib.GObject |
---|
addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addListener, collect, freezeNotify, getBooleanProperty, getData, getDoubleProperty, getFloatProperty, getGObjectFromHandle, getIntProperty, getJavaObjectProperty, getLongProperty, getProperty, getStringProperty, hasProperty, notify, removeEventHandler, removeListener, setBooleanProperty, setData, setDoubleProperty, setFloatProperty, setIntProperty, setJavaObjectProperty, setLongProperty, setProperty, setStringProperty, thawNotify |
Methods inherited from class org.gnu.glib.Struct |
---|
equals, getHandle, getNullHandle, hashCode |
Methods inherited from class java.lang.Object |
---|
getClass, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public Dialog()
public Dialog(org.gnu.glib.Handle handle)
Method Detail |
---|
public static Dialog getDialog(org.gnu.glib.Handle handle)
public int run()
ResponseType
to determine if a standard return value is
emitted. The developer can also set the response type when a button or
widget is added to the dialog. If the dialog is destroyed the run method
will return ResponseType.NONE
.
ResponseType.NONE
if the window was destroyed.public void addButton(java.lang.String buttonText, int responseId)
responseId
.
buttonText
- The text string to display on the button.responseId
- The response ID to emit when the user clicks the button that
is to be added.public void addButton(GtkStockItem stockItem, int responseId)
responseId
.
stockItem
- The stock ID for the button to be added.responseId
- The response ID to emit when the user clicks the button that
is to be added.public void addWidget(Widget child, int responseId)
child
- An activatable Widget to add to the dialog.responseId
- The response ID to emit when the user clicks the widget.public void setDefaultResponse(int responseId)
responseId
- The response ID.public VBox getDialogLayout()
public HButtonBox getActionArea()
public void setHasSeparator(boolean setting)
setting
- Indicates if a separator should be added to the dialog.public boolean getHasSeparator()
public ResponseType getResponseForWidget(Widget widget)
widget
- a widget in the action area of this Dialog.
public void addListener(DialogListener listener)
DialogListener
public void removeListener(DialogListener listener)
addListener(org.gnu.gtk.event.DialogListener)
public java.lang.Class getEventListenerClass(java.lang.String signal)
getEventListenerClass
in class Container
public org.gnu.glib.EventType getEventType(java.lang.String signal)
getEventType
in class Container
public static org.gnu.glib.Type getType()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |