org.gnu.gtk
Class AboutDialog
java.lang.Object
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.gnu.gtk.AboutDialog
- public class AboutDialog
- extends Dialog
Display information about an application.
Gtk's AboutDialog offers a simple way to display information about
a program like its logo, name, copyright, website and license. It
is also possible to give credits to the authors, documenters,
translators and artists who have worked on the program. An about
dialog is typically opened when the user selects the About option
from the Help menu. All parts of the dialog are optional.
Method Summary |
java.lang.String[] |
getAuthors()
Gets the strings which are displayed in the authors tab of the
secondary credits dialog. |
java.lang.String |
getComments()
Gets the comments string displayed in the about dialog. |
java.lang.String |
getCopyright()
Gets the copyright string displayed in the about dialog. |
java.lang.String |
getLicense()
Gets the license information displayed in the secondary
license dialog. |
Pixbuf |
getLogo()
Gets the pixbuf displayed as logo in the about dialog. |
java.lang.String |
getLogoIconName()
Gets the icon name displaed as logo in the about dialog. |
java.lang.String |
getName()
Gets the name displayed in the about dialog. |
java.lang.String |
getTranslatorCredits()
Gets the translator credits string which is displayed in the
translators tab of the secondary credits dialog. |
java.lang.String |
getVersion()
Gets the version string displayed in the about dialog. |
java.lang.String |
getWebsiteLabel()
Sets the label to be used for the website link. |
protected static void |
handleEmailActivate(Handle about,
java.lang.String link)
|
protected static void |
handleURLActivate(Handle about,
java.lang.String link)
|
java.lang.String[] |
setArtists()
Gets the strings which are displayed in the documenters tab of the
secondary credits dialog. |
void |
setArtists(java.lang.String[] val)
Sets the strings which are displayed in the documenters tab of the
secondary credits dialog. |
void |
setAuthors(java.lang.String[] val)
Sets the strings which are displayed in the authors tab of the
secondary credits dialog. |
void |
setComments(java.lang.String val)
Sets the comments string to display in the about dialog. |
void |
setCopyright(java.lang.String val)
Sets the copyright string to display in the about dialog. |
java.lang.String[] |
setDocumenters()
Gets the strings which are displayed in the artists tab of the
secondary credits dialog. |
void |
setDocumenters(java.lang.String[] val)
Sets the strings which are displayed in the artists tab of the
secondary credits dialog. |
static void |
setEmailHook(AboutDialogActivateLinkMethod method)
Set a handler object to be used whenever the user activates an
Email link in the authors, documenters or artists sections. |
void |
setLicense(java.lang.String val)
Sets the license information to be displayed in the secondary
license dialog. |
void |
setLogo(Pixbuf val)
Sets the pixbuf to be displayed as logo in the about dialog. |
void |
setLogoIconName(java.lang.String val)
Sets the icon name displaed as logo in the about dialog. |
void |
setName(java.lang.String val)
Sets the name to display in the about dialog. |
void |
setTranslatorCredits(java.lang.String val)
Sets the translator credits string which is displayed in the
translators tab of the secondary credits dialog. |
static void |
setURLHook(AboutDialogActivateLinkMethod method)
Set a handler object to be used whenever the user activates a URL link
in the authors, documenters or artists sections. |
void |
setVersion(java.lang.String val)
Sets the version string to display in the about dialog. |
java.lang.String |
setWebsite()
Gets the URL used for the website link. |
void |
setWebsite(java.lang.String website)
Sets the URL to use for the website link. |
void |
setWebsiteLabel(java.lang.String val)
Sets the label to be used for the website link. |
Methods inherited from class org.gnu.gtk.Dialog |
addButton, addButton, addListener, addWidget, fireButtonEvent, getActionArea, getActionArea, getDialogLayout, getEventListenerClass, getEventType, getHasSeparator, getType, getVbox, gtk_dialog_add_action_widget, gtk_dialog_add_button, gtk_dialog_get_has_separator, gtk_dialog_get_type, gtk_dialog_new, gtk_dialog_response, gtk_dialog_run, gtk_dialog_set_default_response, gtk_dialog_set_has_separator, gtk_dialog_set_response_sensitive, removeListener, run, setDefaultResponse, setHasSeparator |
Methods inherited from class org.gnu.gtk.Window |
addAccelGroup, deiconify, fullscreen, getAcceptFocus, getDefaultIconList, getFocusOnMap, getFocusWidget, getGravity, getIcon, getIconList, getIconName, getPosition, getScreen, getSize, getSkipPagerHint, getSkipTaskbarHint, getTitle, gtk_window_activate_default, gtk_window_activate_focus, gtk_window_add_accel_group, gtk_window_add_mnemonic, gtk_window_begin_move_drag, gtk_window_begin_resize_drag, gtk_window_deiconify, gtk_window_fullscreen, gtk_window_get_accept_focus, gtk_window_get_decorated, gtk_window_get_default_icon_list, gtk_window_get_default_size, gtk_window_get_destroy_with_parent, gtk_window_get_focus, gtk_window_get_frame_dimensions, gtk_window_get_gravity, gtk_window_get_has_frame, gtk_window_get_icon_list, gtk_window_get_icon, gtk_window_get_mnemonic_modifier, gtk_window_get_modal, gtk_window_get_position, gtk_window_get_resizable, gtk_window_get_role, gtk_window_get_screen, gtk_window_get_size, gtk_window_get_skip_pager_hint, gtk_window_get_skip_taskbar_hint, gtk_window_get_title, gtk_window_get_transient_for, gtk_window_get_type_hint, gtk_window_get_type, gtk_window_has_toplevel_focus, gtk_window_iconify, gtk_window_is_active, gtk_window_list_toplevels, gtk_window_maximize, gtk_window_mnemonic_activate, gtk_window_move, gtk_window_new, gtk_window_parse_geometry, gtk_window_present, gtk_window_remove_accel_group, gtk_window_remove_mnemonic, gtk_window_resize, gtk_window_set_accept_focus, gtk_window_set_auto_startup_notification, gtk_window_set_decorated, gtk_window_set_default_icon_from_file, gtk_window_set_default_icon_list, gtk_window_set_default_icon, gtk_window_set_default_size, gtk_window_set_default, gtk_window_set_destroy_with_parent, gtk_window_set_focus, gtk_window_set_frame_dimensions, gtk_window_set_geometry_hints, gtk_window_set_gravity, gtk_window_set_has_frame, gtk_window_set_icon_from_file, gtk_window_set_icon_list, gtk_window_set_icon, gtk_window_set_keep_above, gtk_window_set_keep_below, gtk_window_set_mnemonic_modifier, gtk_window_set_modal, gtk_window_set_position, gtk_window_set_resizable, gtk_window_set_role, gtk_window_set_screen, gtk_window_set_skip_pager_hint, gtk_window_set_skip_taskbar_hint, gtk_window_set_title, gtk_window_set_transient_for, gtk_window_set_type_hint, gtk_window_set_wmclass, gtk_window_stick, gtk_window_unfullscreen, gtk_window_unmaximize, gtk_window_unstick, hasToplevelFocus, iconify, isActive, listToplevelWindows, maximize, move, present, removeAccelGroup, resize, setAcceptFocus, setAutoStartupNotification, setDecorated, setDefaultIcon, setDefaultIconFromFile, setDefaultIconList, setDefaultIconName, setDefaultSize, setDefaultWidget, setFocusOnMap, setFocusWidget, setGeometryHints, setGravity, setIcon, setIconFromFile, setIconList, setIconName, setKeepAbove, setKeepBelow, setModal, setPosition, setResizable, setScreen, setSkipPagerHint, setSkipTaskbarHint, setTitle, stick, unfullscreen, unmaximize, unstick |
Methods inherited from class org.gnu.gtk.Container |
add, addListener, fireContainerEvent, getBorderWidth, getChildren, getResizeMode, gtk_container_add, gtk_container_check_resize, gtk_container_child_type, gtk_container_get_border_width, gtk_container_get_children, gtk_container_get_focus_chain, gtk_container_get_focus_hadjustment, gtk_container_get_focus_vadjustment, gtk_container_get_resize_mode, gtk_container_get_type, gtk_container_propagate_expose, gtk_container_remove, gtk_container_resize_children, gtk_container_set_border_width, gtk_container_set_focus_chain, gtk_container_set_focus_child, gtk_container_set_focus_hadjustment, gtk_container_set_focus_vadjustment, gtk_container_set_reallocate_redraws, gtk_container_set_resize_mode, gtk_container_unset_focus_chain, remove, removeListener, resizeChildren, setBorderWidth, setResizeMode |
Methods inherited from class org.gnu.gtk.Widget |
activate, addListener, addListener, addListener, addListener, addListener, addListener, addListener, addListener, canActivateAccel, createContext, createLayout, destroy, draw, drawArea, drawArea, findListener, finish, fireBooleanLifeCycleEvent, fireDragDestinationEvent, fireDragSourceEvent, fireExposeEvent, fireFocusEvent, fireKeyEvent, fireLifeCycleEvent, fireMouseEvent, fireMouseMotionEvent, getAccessible, getColormap, getContext, getData, getDisplay, getModifierStyle, getParent, getParentWindow, getPointer, getRootWindow, getSensitive, getStyle, getToplevel, getWindow, grabDefault, grabFocus, gtk_drag_dest_set, gtk_drag_dest_unset, gtk_drag_finish, gtk_drag_get_data, gtk_drag_highlight, gtk_drag_source_set_icon_pixbuf, gtk_drag_source_set_icon_stock, gtk_drag_source_set_icon, gtk_drag_source_set, gtk_drag_source_unset, gtk_drag_unhighlight, gtk_widget_activate, gtk_widget_add_accelerator, gtk_widget_add_events, gtk_widget_add_mnemonic_label, gtk_widget_can_activate_accel, gtk_widget_child_focus, gtk_widget_child_notify, gtk_widget_class_path, gtk_widget_create_pango_context, gtk_widget_create_pango_layout, gtk_widget_destroy, gtk_widget_destroyed, gtk_widget_ensure_style, gtk_widget_event, gtk_widget_freeze_child_notify, gtk_widget_get_accessible, gtk_widget_get_ancestor, gtk_widget_get_child_requisition, gtk_widget_get_child_visible, gtk_widget_get_colormap, gtk_widget_get_composite_name, gtk_widget_get_default_colormap, gtk_widget_get_default_direction, gtk_widget_get_default_style, gtk_widget_get_default_visual, gtk_widget_get_direction, gtk_widget_get_display, gtk_widget_get_events, gtk_widget_get_extension_events, gtk_widget_get_modifier_style, gtk_widget_get_name, gtk_widget_get_pango_context, gtk_widget_get_parent_window, gtk_widget_get_parent, gtk_widget_get_pointer, gtk_widget_get_root_window, gtk_widget_get_screen, gtk_widget_get_sensitive, gtk_widget_get_settings, gtk_widget_get_size_request, gtk_widget_get_style, gtk_widget_get_toplevel, gtk_widget_get_type, gtk_widget_get_visual, gtk_widget_get_window, gtk_widget_grab_default, gtk_widget_grab_focus, gtk_widget_has_screen, gtk_widget_hide_all, gtk_widget_hide_on_delete, gtk_widget_hide, gtk_widget_intersect, gtk_widget_is_ancestor, gtk_widget_is_focus, gtk_widget_list_accel_closures, gtk_widget_list_mnemonic_labels, gtk_widget_map, gtk_widget_mnemonic_activate, gtk_widget_modify_base, gtk_widget_modify_bg, gtk_widget_modify_fg, gtk_widget_modify_font, gtk_widget_modify_style, gtk_widget_modify_text, gtk_widget_path, gtk_widget_pop_colormap, gtk_widget_pop_composite_child, gtk_widget_push_colormap, gtk_widget_push_composite_child, gtk_widget_queue_draw_area, gtk_widget_queue_draw, gtk_widget_queue_resize, gtk_widget_realize, gtk_widget_ref, gtk_widget_region_intersect, gtk_widget_remove_accelerator, gtk_widget_remove_mnemonic_label, gtk_widget_render_icon, gtk_widget_reparent, gtk_widget_reset_rc_styles, gtk_widget_send_expose, gtk_widget_set_accel_path, gtk_widget_set_app_paintable, gtk_widget_set_child_visible, gtk_widget_set_colormap, gtk_widget_set_composite_name, gtk_widget_set_default_colormap, gtk_widget_set_default_direction, gtk_widget_set_direction, gtk_widget_set_double_buffered, gtk_widget_set_events, gtk_widget_set_extension_events, gtk_widget_set_name, gtk_widget_set_parent_window, gtk_widget_set_parent, gtk_widget_set_redraw_on_allocate, gtk_widget_set_scroll_adjustments, gtk_widget_set_sensitive, gtk_widget_set_size_request, gtk_widget_set_state, gtk_widget_set_style, gtk_widget_shape_combine_mask, gtk_widget_show_all, gtk_widget_show_now, gtk_widget_show, gtk_widget_size_allocate, gtk_widget_size_request, gtk_widget_style_get_property, gtk_widget_thaw_child_notify, gtk_widget_translate_coordinates, gtk_widget_unmap, gtk_widget_unparent, gtk_widget_unrealize, gtk_widget_unref, handleButtonPressed, handleButtonReleased, handleDelete, handleDragDataGet, handleDragDestination, handleExpose, handleFocusIn, handleFocusOut, handleHide, handleKeyPressed, handleKeyReleased, handleMap, handleMouseEnter, handleMouseLeave, handleMouseMotion, handleNoExpose, handleRealize, handleScroll, handleShow, handleUnmap, hasFocus, hasScreen, hide, hideAll, highlight, intersect, isAncestor, makeWidget, modifyStyle, popColormap, pushColormap, realize, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, reparent, setBackgroundColor, setBaseColor, setColormap, setDoubleBuffered, setDragDestination, setDragIcon, setDragIconPixbuf, setDragIconStock, setDragSource, setFont, setForegroundColor, setMinimumSize, setNoDragDestination, setNoDragSource, setSensitive, setTextColor, shapeCombineMask, show, showAll, unHighlight |
Methods inherited from class org.gnu.glib.GObject |
addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addListener, equals, freezeNotify, getBooleanProperty, getData, getData, getDoubleProperty, getFloatProperty, getGObjectFromHandle, getHandle, getIntFromHandle, getIntProperty, getJavaObjectProperty, getLongProperty, getNullHandle, getPixbufProperty, getProperty, getStringFromHandle, getStringProperty, hashCode, hasProperty, instantiateJGObjectFromGType, notify, removeEventHandler, removeListener, retrieveGObject, setBooleanProperty, setData, setData, setDoubleProperty, setFloatProperty, setHandle, setIntProperty, setJavaObjectProperty, setLongProperty, setPixbufProperty, setProperty, setStringProperty, thawNotify |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
AboutDialog
public AboutDialog(Handle handle)
- Internal constructor.
AboutDialog
public AboutDialog()
- Create a new AboutDialog.
setName
public void setName(java.lang.String val)
- Sets the name to display in the about dialog.
- Overrides:
setName
in class Widget
- Parameters:
val
- The name for the widget.
getName
public java.lang.String getName()
- Gets the name displayed in the about dialog.
- Overrides:
getName
in class Widget
- Returns:
- The name for the widget.
setVersion
public void setVersion(java.lang.String val)
- Sets the version string to display in the about dialog.
getVersion
public java.lang.String getVersion()
- Gets the version string displayed in the about dialog.
setCopyright
public void setCopyright(java.lang.String val)
- Sets the copyright string to display in the about dialog.
This should be a short string of one or two lines.
getCopyright
public java.lang.String getCopyright()
- Gets the copyright string displayed in the about dialog.
setComments
public void setComments(java.lang.String val)
- Sets the comments string to display in the about dialog.
This should be a short string of one or two lines.
getComments
public java.lang.String getComments()
- Gets the comments string displayed in the about dialog.
setLicense
public void setLicense(java.lang.String val)
- Sets the license information to be displayed in the secondary
license dialog.
If license is null, the license button is hidden.
- Parameters:
val
- The license information or NULL.
getLicense
public java.lang.String getLicense()
- Gets the license information displayed in the secondary
license dialog.
setWebsite
public void setWebsite(java.lang.String website)
- Sets the URL to use for the website link.
- Parameters:
website
- A URL string starting with "http://".
setWebsite
public java.lang.String setWebsite()
- Gets the URL used for the website link.
setWebsiteLabel
public void setWebsiteLabel(java.lang.String val)
- Sets the label to be used for the website link. It defaults to the
website URL.
getWebsiteLabel
public java.lang.String getWebsiteLabel()
- Sets the label to be used for the website link. It defaults to the
website URL.
setAuthors
public void setAuthors(java.lang.String[] val)
- Sets the strings which are displayed in the authors tab of the
secondary credits dialog.
getAuthors
public java.lang.String[] getAuthors()
- Gets the strings which are displayed in the authors tab of the
secondary credits dialog.
setDocumenters
public void setDocumenters(java.lang.String[] val)
- Sets the strings which are displayed in the artists tab of the
secondary credits dialog.
setDocumenters
public java.lang.String[] setDocumenters()
- Gets the strings which are displayed in the artists tab of the
secondary credits dialog.
setArtists
public void setArtists(java.lang.String[] val)
- Sets the strings which are displayed in the documenters tab of the
secondary credits dialog.
setArtists
public java.lang.String[] setArtists()
- Gets the strings which are displayed in the documenters tab of the
secondary credits dialog.
setTranslatorCredits
public void setTranslatorCredits(java.lang.String val)
- Sets the translator credits string which is displayed in the
translators tab of the secondary credits dialog.
The intended use for this string is to display the translator
of the language which is currently used in the user
interface.
It is a good idea to use the customary msgid
"translator-credits" for this purpose, since translators will
already know the purpose of that msgid, and since
AboutDialog will detect if "translator-credits" is
untranslated and hide the tab.
getTranslatorCredits
public java.lang.String getTranslatorCredits()
- Gets the translator credits string which is displayed in the
translators tab of the secondary credits dialog.
setLogo
public void setLogo(Pixbuf val)
- Sets the pixbuf to be displayed as logo in the about dialog.
If it is null, the default window icon set with
Window.setDefaultIcon(org.gnu.gdk.Pixbuf)
will be used.
getLogo
public Pixbuf getLogo()
- Gets the pixbuf displayed as logo in the about dialog.
setLogoIconName
public void setLogoIconName(java.lang.String val)
- Sets the icon name displaed as logo in the about dialog.
getLogoIconName
public java.lang.String getLogoIconName()
- Gets the icon name displaed as logo in the about dialog.
setURLHook
public static void setURLHook(AboutDialogActivateLinkMethod method)
- Set a handler object to be used whenever the user activates a URL link
in the authors, documenters or artists sections.
setEmailHook
public static void setEmailHook(AboutDialogActivateLinkMethod method)
- Set a handler object to be used whenever the user activates an
Email link in the authors, documenters or artists sections.
handleURLActivate
protected static void handleURLActivate(Handle about,
java.lang.String link)
handleEmailActivate
protected static void handleEmailActivate(Handle about,
java.lang.String link)