diff options
Diffstat (limited to 'kdejava/koala/org/kde/koala/KAboutDialog.java')
| -rw-r--r-- | kdejava/koala/org/kde/koala/KAboutDialog.java | 379 |
1 files changed, 379 insertions, 0 deletions
diff --git a/kdejava/koala/org/kde/koala/KAboutDialog.java b/kdejava/koala/org/kde/koala/KAboutDialog.java new file mode 100644 index 00000000..6326f3b0 --- /dev/null +++ b/kdejava/koala/org/kde/koala/KAboutDialog.java @@ -0,0 +1,379 @@ +//Auto-generated by kalyptus. DO NOT EDIT. +package org.kde.koala; + +import org.kde.qt.Qt; +import org.kde.qt.QColor; +import org.kde.qt.QMetaObject; +import org.kde.qt.QtSupport; +import org.kde.qt.QPixmap; +import org.kde.qt.QMouseEvent; +import org.kde.qt.QWidget; +import org.kde.qt.QFrame; + +/** + + A KDialogBase with predefined main widget. + As a KDialogBase it uses your application wide settings + for KDialogBase + objects (base frame tiles, main frame tiles etc). + To use it, simply create a KAboutDialog object, set all (or some) of its + properties and show it. Do not derive it to create your own about dialog + until you need some cool features that are unsupported and you have + contacted me to add them. + The dialog can be created using two different constructors. The + difference between these constructors is the available components that + can be used to build the contents of the dialog. The first (Constructor I) + provides a number of easy to use methods. Basically it allows you + to add the components of choice, and the components are placed in a + predefined layout. You do not have to plan the layout. Everything is + taken care of. + The second constructor (Constructor II) works in quite the same manner + as the first, but you have better control on where the components + are postioned in the layout and you have access to an extended number + of components you can install such as titles, product information, + a tabbed pages (where you can display rich text with url links) and + a person (developer) information field. The "About KDE" dialog box is + created with Constructor II. + For the derived features, see the basic class KDialogBase. + See {@link KAboutDialogSignals} for signals emitted by KAboutDialog + @author Mirko Boehm (mirko@kde.org) and Espen Sand (espensa@online.no) + + @short A KDialogBase with predefined main widget. + @see KDialogBase + +*/ +public class KAboutDialog extends KDialogBase { + protected KAboutDialog(Class dummy){super((Class) null);} + /** + Layout formats. + @short Layout formats. + */ + public static final int AbtPlain = 0x0001; + public static final int AbtTabbed = 0x0002; + public static final int AbtTitle = 0x0004; + public static final int AbtImageLeft = 0x0008; + public static final int AbtImageRight = 0x0010; + public static final int AbtImageOnly = 0x0020; + public static final int AbtProduct = 0x0040; + public static final int AbtKDEStandard = AbtTabbed|AbtTitle|AbtImageLeft; + public static final int AbtAppStandard = AbtTabbed|AbtTitle|AbtProduct; + public static final int AbtImageAndTitle = AbtPlain|AbtTitle|AbtImageOnly; + + public native QMetaObject metaObject(); + public native String className(); + /** + The standard Qt constructor (Constructor I). + Add components with the following methods: + setLogo(), setAuthor(), setMaintainer(), + addContributor(), or setVersion(). + The dialog will be laid out automatically. + @short The standard Qt constructor (Constructor I). + */ + public KAboutDialog(QWidget parent, String name, boolean modal) { + super((Class) null); + newKAboutDialog(parent,name,modal); + } + private native void newKAboutDialog(QWidget parent, String name, boolean modal); + public KAboutDialog(QWidget parent, String name) { + super((Class) null); + newKAboutDialog(parent,name); + } + private native void newKAboutDialog(QWidget parent, String name); + public KAboutDialog(QWidget parent) { + super((Class) null); + newKAboutDialog(parent); + } + private native void newKAboutDialog(QWidget parent); + public KAboutDialog() { + super((Class) null); + newKAboutDialog(); + } + private native void newKAboutDialog(); + /** + The extended constructor. (Constructor II). + Add components with the methods: + setTitle(), setImage(), setImageBackgroundColor(), + setImageFrame(), setProduct(), addTextPage(), + addContainerPage(), addContainer(), or addPage(). + @param dialogLayout Use a mask of LayoutType flags. + @param caption The dialog caption. The text you specify is prepended + by i18n("About"). + @param buttonMask Specifies what buttons will be visible. + @param defaultButton Specifies what button will be marked as the default. + @param parent Parent of the dialog. + @param name Dialog name (for internal use only) + @param modal Sets dialog modality. If false, the rest of the + program interface (other dialogs, for example) is accessible while + the dialog is open. + @param separator If true, a separator line is drawn between the action + buttons an the main widget. + @param user1 User button1 text. + @param user2 User button2 text. + @param user3 User button3 text. + @short The extended constructor. + */ + public KAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal, boolean separator, String user1, String user2, String user3) { + super((Class) null); + newKAboutDialog(dialogLayout,caption,buttonMask,defaultButton,parent,name,modal,separator,user1,user2,user3); + } + private native void newKAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal, boolean separator, String user1, String user2, String user3); + public KAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal, boolean separator, String user1, String user2) { + super((Class) null); + newKAboutDialog(dialogLayout,caption,buttonMask,defaultButton,parent,name,modal,separator,user1,user2); + } + private native void newKAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal, boolean separator, String user1, String user2); + public KAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal, boolean separator, String user1) { + super((Class) null); + newKAboutDialog(dialogLayout,caption,buttonMask,defaultButton,parent,name,modal,separator,user1); + } + private native void newKAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal, boolean separator, String user1); + public KAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal, boolean separator) { + super((Class) null); + newKAboutDialog(dialogLayout,caption,buttonMask,defaultButton,parent,name,modal,separator); + } + private native void newKAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal, boolean separator); + public KAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal) { + super((Class) null); + newKAboutDialog(dialogLayout,caption,buttonMask,defaultButton,parent,name,modal); + } + private native void newKAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name, boolean modal); + public KAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name) { + super((Class) null); + newKAboutDialog(dialogLayout,caption,buttonMask,defaultButton,parent,name); + } + private native void newKAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent, String name); + public KAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent) { + super((Class) null); + newKAboutDialog(dialogLayout,caption,buttonMask,defaultButton,parent); + } + private native void newKAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton, QWidget parent); + public KAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton) { + super((Class) null); + newKAboutDialog(dialogLayout,caption,buttonMask,defaultButton); + } + private native void newKAboutDialog(int dialogLayout, String caption, int buttonMask, int defaultButton); + /** + Adjusts the dialog. + You can call this method after you have set up all + the contents but it is not required. It is done automatically when + show() is executed. + @short Adjusts the dialog. + */ + public native void adjust(); + /** + Makes a modeless (modal = false in constructor) dialog visible. + If you reimplement this method make sure you run it + in the new method (e.g., show()). Reimplemented + from KDialogBase. + @short Makes a modeless (modal = false in constructor) dialog visible. + */ + public native void show(); + /** + Makes a modeless (modal = false in constructor) dialog visible. + If you reimplmement this method make sure you run it + in the new method (i.e., show( parent )). + @param centerParent Center the dialog with respect to this widget. + @short Makes a modeless (modal = false in constructor) dialog visible. + */ + public native void show(QWidget centerParent); + /** + (Constructor II only) + Sets a title (not caption) in the uppermost area of the dialog. + @param title Title string. + @short (Constructor II only) Sets a title (not caption) in the uppermost area of the dialog. + */ + public native void setTitle(String title); + /** + (Constructor II only) + Define an image to be shown in the dialog. The position is dependent + on the <code>dialogLayout</code> in the constructor + @param fileName Path to image file. + @short (Constructor II only) Define an image to be shown in the dialog. + */ + public native void setImage(String fileName); + /** + Overloaded version of setProgramLogo(QPixmap pixmap). + @short Overloaded version of setProgramLogo(QPixmap pixmap). + */ + public native void setProgramLogo(String fileName); + /** + (Constructor II only) + Define the program logo to be shown in the dialog. Use this to override the + default program logo. For example, use this function if the + KAboutDialog is for a panel applet and you want to override the + appletproxy logo with your own pixmap. + @param pixmap The logo pixmap. + @short (Constructor II only) Define the program logo to be shown in the dialog. + */ + public native void setProgramLogo(QPixmap pixmap); + /** + (Constructor II only) + The image has a minimum size, but is centered within an area if the + dialog box is enlarged by the user. You set the background color + of the area with this method. + @param color Background color. + @short (Constructor II only) The image has a minimum size, but is centered within an area if the dialog box is enlarged by the user. + */ + public native void setImageBackgroundColor(QColor color); + /** + (Constructor II only) + Enables or disables a frame around the image. The frame is, by default, + enabled in the constructor + @param state A value of <code>true</code> enables the frame + @short (Constructor II only) Enables or disables a frame around the image. + */ + public native void setImageFrame(boolean state); + /** + (Constructor II only) + Prints the application name, KDE version, author, a copyright sign + and a year string. To the left of the text the standard application + icon is displayed. + @param appName The application name. + @param version Application version. + @param author One or more authors. + @param year A string telling when the application was made. + @short (Constructor II only) Prints the application name, KDE version, author, a copyright sign and a year string. + */ + public native void setProduct(String appName, String version, String author, String year); + /** + (Constructor II only) + Adds a text page to a tab box. The text can be regular text or + rich text. The rich text can contain URLs and mail links. + @param title Tab name. + @param text The text to display. + @param richText Set this to <code>true</code> if 'text' is rich text. + @param numLines The text area height will be adjusted so that this + is the minimum number of lines of text that are visible. + @return The frame that contains the page. + + @short (Constructor II only) Adds a text page to a tab box. + */ + public native QFrame addTextPage(String title, String text, boolean richText, int numLines); + public native QFrame addTextPage(String title, String text, boolean richText); + public native QFrame addTextPage(String title, String text); + /** + (Constructor II only) + Adds a license page to a tab box. + @param title Tab name. + @param text The text to display. + @param numLines The text area height will be adjusted so that this + is the minimum number of lines of text that are visible. + @return The frame that contains the page. + + @short (Constructor II only) Adds a license page to a tab box. + */ + public native QFrame addLicensePage(String title, String text, int numLines); + public native QFrame addLicensePage(String title, String text); + /** + (Constructor II only) + Adds a container to a tab box. You can add text and images to a + container. + @param title Tab name. + @param childAlignment Specifies how the children of the container are + aligned with respect to the container. + @param innerAlignment Specifies how the children are aligned with + respect to each other. + @return The new container. + + @short (Constructor II only) Adds a container to a tab box. + */ + public native KAboutContainer addContainerPage(String title, int childAlignment, int innerAlignment); + public native KAboutContainer addContainerPage(String title, int childAlignment); + public native KAboutContainer addContainerPage(String title); + /** + (Constructor II only) + Adds a container inside a QScrollView to a tab box. You can add text + and images to a container. + @param title Tab name. + @param childAlignment Specifies how the children of the container are + aligned with respect to the container. + @param innerAlignment Specifies how the children are aligned with + respect to each other. + @return The new container. + + @short (Constructor II only) Adds a container inside a QScrollView to a tab box. + */ + public native KAboutContainer addScrolledContainerPage(String title, int childAlignment, int innerAlignment); + public native KAboutContainer addScrolledContainerPage(String title, int childAlignment); + public native KAboutContainer addScrolledContainerPage(String title); + /** + (Constructor II only) + Adds a container. You can add text and images to a container. + @param childAlignment Specifies how the children of the container are + aligned with respect to the container. + @param innerAlignment Specifies how the children are aligned with + respect to each other. + @return The new container. + + @short (Constructor II only) Adds a container. + */ + public native KAboutContainer addContainer(int childAlignment, int innerAlignment); + /** + (Constructor II only) + Adds an empty page to a tab box. + @param title Tab name + @return The new page. + + @short (Constructor II only) Adds an empty page to a tab box. + */ + public native QFrame addPage(String title); + /** + (Constructor I only) + Sets the image as the application logo. + @short (Constructor I only) Sets the image as the application logo. + */ + public native void setLogo(QPixmap arg1); + /** + (Constructor I only) + Sets the author's name and email address. + @short (Constructor I only) Sets the author's name and email address. + */ + public native void setAuthor(String name, String email, String url, String work); + /** + (Constructor I only) + Sets the maintainer's name and email address. + @short (Constructor I only) Sets the maintainer's name and email address. + */ + public native void setMaintainer(String name, String email, String url, String work); + /** + (Constructor I only) + Show this person as one of the major contributors. + @short (Constructor I only) Show this person as one of the major contributors. + */ + public native void addContributor(String name, String email, String url, String work); + /** + (Constructor I only) + Sets the text describing the version. + @short (Constructor I only) Sets the text describing the version. + */ + public native void setVersion(String name); + /** + Create a modal dialog with an image in the upper area with a + URL link below. + @short Create a modal dialog with an image in the upper area with a URL link below. + */ + public static native void imageURL(QWidget parent, String caption, String path, QColor imageColor, String url); + /** + Connected to widget.sendEmail. + @short Connected to widget.sendEmail. + */ + protected native void sendEmailSlot(String name, String email); + /** + Open this URL. + @short Open this URL. + */ + protected native void openURLSlot(String url); + /** + (Constructor II only) + Tells the position of the mouse cursor when the left mouse button + is pressed above an image + @short (Constructor II only) Tells the position of the mouse cursor when the left mouse button is pressed above an image + */ + protected native void mouseTrackSlot(int mode, QMouseEvent e); + /** Deletes the wrapped C++ instance */ + protected native void finalize() throws InternalError; + /** Delete the wrapped C++ instance ahead of finalize() */ + public native void dispose(); + /** Has the wrapped C++ instance been deleted? */ + public native boolean isDisposed(); +} |