|
java-gnome version 4.0.13 | ||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Objectorg.freedesktop.bindings.Pointer
org.freedesktop.bindings.Proxy
org.gnome.glib.Object
org.gnome.gtk.Object
org.gnome.gtk.Widget
org.gnome.gtk.Container
org.gnome.gtk.Bin
org.gnome.gtk.Window
org.gnome.gtk.Dialog
org.gnome.gtk.AboutDialog
public class AboutDialog
A Dialog which presents information about a program. The AboutDialog presents simple
meta information including program
name
, a
short description
,
copyright
info, and then lists of
authors
, documenters
, artists
responsible for the
program. Those who contributed by translating
the application can also be listed.
As a convention, every GNOME application has a MenuItem labelled "About" in the main "Help" menu.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.gnome.gtk.Dialog |
---|
Dialog.Response |
Nested classes/interfaces inherited from class org.gnome.gtk.Window |
---|
Window.ConfigureEvent, Window.DeleteEvent |
Nested classes/interfaces inherited from class org.gnome.gtk.Widget |
---|
Widget.ButtonPressEvent, Widget.ButtonReleaseEvent, Widget.EnterNotifyEvent, Widget.ExposeEvent, Widget.FocusInEvent, Widget.FocusOutEvent, Widget.Hide, Widget.KeyPressEvent, Widget.KeyReleaseEvent, Widget.LeaveNotifyEvent, Widget.MapEvent, Widget.PopupMenu, Widget.ScrollEvent, Widget.UnmapEvent, Widget.VisibilityNotifyEvent |
Constructor Summary | |
---|---|
AboutDialog()
Instantiate a new AboutDialog. |
Method Summary | |
---|---|
void |
setArtists(String[] people)
Add a list of artists to the AboutDialog. |
void |
setAuthors(String[] people)
Add a list of authors to the AboutDialog. |
void |
setComments(String text)
Set a simple description of the program. |
void |
setCopyright(String text)
Specify the copyright holder of the application. |
void |
setDocumenters(String[] people)
Add a list of documenters to the AboutDialog. |
void |
setLicense(String text)
Add a "licence" Button to the AboutDialog. |
void |
setLogo(Pixbuf icon)
Set the image to be displayed in the AboutDialog. |
void |
setProgramName(String name)
Specify the name of the application. |
void |
setTranslatorCredits(String credits)
Add a tab to the AboutDialog's Credit popup listing the people who have contributed to translating the application into the active language. |
void |
setVersion(String version)
Set the version number of this release. |
void |
setWebsite(String website)
Set a link to your website. |
void |
setWrapLicense(boolean setting)
Wrap the licence text. |
Methods inherited from class org.gnome.gtk.Dialog |
---|
add, addButton, addButton, connect, emitResponse, run |
Methods inherited from class org.gnome.gtk.Window |
---|
connect, connect, getHeight, getMaximized, getPositionX, getPositionY, getScreen, getWidth, move, present, resize, setDecorated, setDefaultSize, setFullscreen, setGravity, setIcon, setKeepAbove, setKeepBelow, setMaximize, setModal, setPosition, setResizable, setSkipPagerHint, setSkipTaskbarHint, setStick, setTitle, setTransientFor, setTypeHint |
Methods inherited from class org.gnome.gtk.Bin |
---|
getChild |
Methods inherited from class org.gnome.gtk.Container |
---|
getChildren, remove, setBorderWidth |
Methods inherited from class org.gnome.gtk.Widget |
---|
activate, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, getAllocation, getCanDefault, getCanFocus, getHasFocus, getName, getParent, getRequisition, getToplevel, getWindow, grabAdd, grabDefault, grabFocus, grabRemove, hide, modifyBackground, modifyBase, modifyFont, modifyText, queueDraw, queueDrawArea, setCanDefault, setCanFocus, setColormap, setName, setSensitive, setSizeRequest, setTooltipMarkup, setTooltipText, show, showAll |
Methods inherited from class org.freedesktop.bindings.Pointer |
---|
toString |
Methods inherited from class Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public AboutDialog()
Method Detail |
---|
public void setArtists(String[] people)
about.setArtists(new String[] { "Joao Victor <jvital@gmail.com>" });
public void setAuthors(String[] people)
about.setAuthors(new String[] { "Andrew Cowie <andrew@operationaldynamics.com>", "Srichand Pendyala <srichand.pendyala@gmail.com>", "Vreixo Formoso Lopes <metalpain2002@yahoo.es>", "Sebastian Mancke <s.mancke@tarent.de>" });It is indeed tradition for authors of Open Source Software to include their email addresses when identifying their work.
public void setComments(String text)
public void setCopyright(String text)
setCopyright("Copyright (c) 2008 ACME, Inc");
public void setDocumenters(String[] people)
about.setDocumenters(new String[] { "Guillaume Mazoyer <respawneral@gmail.com>", "Stefan Prelle <stefan@prelle.org>", "Serkan Kaba <serkan@gentoo.org>" });
public void setLicense(String text)
If null
the licence Button is hidden.
public void setLogo(Pixbuf icon)
Gtk.setDefaultIcon()
.
public void setProgramName(String name)
The Epiphany Web Browser
", whereas
others will use the project name, for example "epiphany
".
This will be shown prominently in a large font as the title of the
Dialog.
public void setTranslatorCredits(String credits)
This one is a bit different than authors,
artists, and documenters in that it is expected
that you'll pass the result of looking up the translation of the string
"translator-credits"
as follows:
about.setTranslatorCredits(_("translator-credits"));This way, the user of your program will be shown the list of people who worked on the translation for that particular locale. The translation for the
"translator-credits"
string in the PO file should
still be names and email addresses as shown in
setAuthors()
.
See Internationalization
for more details about the use of the
_()
function.
You could of course use any string as the index for lookup, but "translator-credits" is the accepted convention, and people doing translation work will recognize it.
public void setVersion(String version)
public void setWebsite(String website)
http://www.example.com/
format.
At the moment this "link" is just plain text and not live.
public void setWrapLicense(boolean setting)
true
, the licence text will be
automatically wrapped and the initial dialog size will be preserved.
|
![]() java-gnome |
||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |