Graphical User Interface (GUI) - Java Swing - Revizia istoricului

Zhascsi: /* Example */

2015-12-05T01:59:29Z

Example

Rhobincu: a redenumit Graphical User Interface (GUI) - Java Swing and JavaFX în Graphical User Interface (GUI) - Java Swing

2013-12-23T14:29:40Z

a redenumit Graphical User Interface (GUI) - Java Swing and JavaFX în Graphical User Interface (GUI) - Java Swing

Rhobincu: /* JavaFX */

2013-12-23T14:29:12Z

JavaFX

Rhobincu: /* Exemplu */

2013-12-23T14:27:55Z

Exemplu

Rhobincu: /* Event Handlers */

2013-12-23T14:23:42Z

Event Handlers

Rhobincu: /* Layouts */

2013-12-23T14:16:31Z

Layouts

Rhobincu: /* Components */

2013-12-23T14:09:27Z

Components

Rhobincu: /* Components */

2013-12-23T14:01:24Z

Components

Rhobincu la 23 decembrie 2013 13:53

2013-12-23T13:53:29Z

Rhobincu: Pagină nouă: În multe dintre aplicațiile pe care le veți dezvolta folosing Java, veți avea nevoie și de o interfață grafică adecvată: ferestre, butoane, câmpuri de editare, checkboxuri...

2013-12-23T13:47:39Z

Pagină nouă: În multe dintre aplicațiile pe care le veți dezvolta folosing Java, veți avea nevoie și de o interfață grafică adecvată: ferestre, butoane, câmpuri de editare, checkboxuri...

Pagină nouă

În multe dintre aplicațiile pe care le veți dezvolta folosing Java, veți avea nevoie și de o interfață grafică adecvată: ferestre, butoane, câmpuri de editare, checkboxuri, etc. Există mai multe biblioteci de dezvoltare pentru interfețe grafice, cea mai cunoscută fiind [http://docs.oracle.com/javase/tutorial/ui/overview/index.html Java Swing] și cea mai nouă fiind [http://docs.oracle.com/javafx/index.html JavaFX].

== Java Swing ==

Pachetul care conține majoritatea claselor pentru aplicațiile Swing este [http://docs.oracle.com/javase/7/docs/api/javax/swing/package-summary.html java.swing] dar sunt utilizate și multe din clasele din vechea biblotecă GUI, [http://docs.oracle.com/javase/7/docs/api/java/awt/package-summary.html java.awt]. Clasa principală pentru aplicații Java Swing este clasa [http://docs.oracle.com/javase/7/docs/api/javax/swing/JFrame.html javax.swing.JFrame].

Frame-ul este fereastra principală a unei interfețe grafice. Este elementul care are asociată bara de deasupra, care conține icon-ul, numele aplicației și cele trei butoane: minimize, maximize, close:

[[Fișier:emptyframe.png|Exemplu de frame fără elemente]]

În continuare este prezentat un frame ce conține cele mai utilizate componente Swing:

[[Fișier:fullframe.png|Exemplu de frame cu elemente]]

=== Componente ===

Toate obiectele Swing, cu excepția clasei '''JFrame''', moștenesc clasa [http://docs.oracle.com/javase/7/docs/api/javax/swing/JComponent.html javax.swing.JComponent], care la rândul ei moștenește (indirect) clasa [http://docs.oracle.com/javase/7/docs/api/java/awt/Container.html java.awt.Container]. Astfel, se creează o ierarhie de componente, fiecare element (numit ''parent'') înglobând alte sub-componente (numite ''children''). În continuare se vor prezenta elementele necesare realizării temei 6. Pentru descrierea altor elemente mai avansate, citiți [http://docs.oracle.com/javase/tutorial/uiswing/components/index.html tutorial-ul Oracle].

==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JPanel.html javax.swing.JPanel] ====

'''JPanel''' este un container generic care poate conține alte elemente. Poate fi vizibil, schimbându-i-se culoarea background-ului, sau modelul marginii, sau invizibil, folosit doar pentru ierarhizarea conținutului. Este indicat să nu plasați alte obiecte direct pe un '''JFrame''', ci doar un '''JPanel''' care să conțină restul de elemente. Acest lucru este foarte util și când aveți nevoie să schimbați complet elementele dintr-un '''JFrame''', înlocuiți doar '''JPanel'''-ul.

==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JLabel.html javax.swing.JLabel] ====

'''JLabel''' este un component utilizat pentru a afișa text sau imagini într-un container.

==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JButton.html javax.swing.JButton] ====

'''JButton''' este, cum îi spune și numele, un buton. Acesta poate avea afișat un text sau o imagine. De cele mai multe ori este utilizat asociindu-i-se un ''Event Handler'' de tip ''ActionListener'' (vezi [[#Event Handlers]]) care se declanșează când acesta este apăsat (se dă click pe el).

==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JTextField.html javax.swing.JTextField] ====

'''JTextField''' reprezintă o zonă în care se poate introduce text scurt, de o singură linie. Și acestul element i se poate asocia un ''Event Handler'' de tip ''ActionListener'' care se declanșează când se apasă tasta ''Enter'' în zona de editare.

==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JTextArea.html javax.swing.JTextArea] ====

'''JTextArea''' reprezintă o zonă în care se poate introduce text de mai multe linii.

=== Layouts ===

O altă serie de clase necesară pentru implementarea unei interfețe grafice este setul de clase care extind interfața [http://docs.oracle.com/javase/7/docs/api/java/awt/LayoutManager.html java.awt.LayoutManager]. Aceste clase descriu modul în care elementele se așează într-un '''Container'''. Cele mai importante sunt:

==== [http://docs.oracle.com/javase/7/docs/api/java/awt/FlowLayout.html java.awt.FlowLayout] ====

'''FlowLayout''' este utilizat pentru a așseza elementele pe orizontală, până când nu mai încap, în care situație se trece pe rândul următor. Acesta este cel mai simplu tip de layout.

==== [http://docs.oracle.com/javase/7/docs/api/java/awt/GridLayout.html java.awt.GridLayout] ====

'''GridLayout''' este utilizat pentru a așseza elementele într-o matrice cu număr configurabil de linii și coloane.

==== [http://docs.oracle.com/javase/7/docs/api/java/awt/BorderLayout.html java.awt.BorderLayout] ====

'''BorderLayout''' este utilizat pentru a așseza elementele dealungul celor patru margini și în centru, adică NORTH, SOUTH, EAST, WEST și CENTER. Un singur element poate fi plasat în fiecare din aceste poziții.

==== [http://docs.oracle.com/javase/7/docs/api/java/awt/CardLayout.html java.awt.CardLayout] ====

'''CardLayout''' este utilizat pentru a adăuga mai multe componente unui '''Container''' din care doar unul este vizibil la un moment dat. Acest tip de ''layout'' este util pentru generarea de aplicații tip ''wizard'' în care utilizatorul trece de la o fereastră la alta cu ajutorul unor butoane ''Next'' și ''Previous''.

Mai multe despre elemente de tip Layout, în [http://docs.oracle.com/javase/tutorial/uiswing/layout/visual.html tutorial-ul Oracle].

=== Event Handlers ===

Fiecare '''JComponent''' suportă o listă de evenimente la care e sensibil. Fiecărui eveniment i se poate asociaza o acțiune care se execută când acel eveniment se declanșează. De exemplu, când un buton este apăsat, sau când cursorul de la mouse a intrat în zona ocupată de componentă, sau când s-a tastat ceva într-o zonă de text, etc. Aceste ''handler''-e sunt, de fapt, niște metode, definite în anumite interfețe. Aceste metode se excută în paralel cu programul principal (ca și thread-uri) în momentul în care evenimentul se declanșează. Metodele care adaugă un ''handler'' unui obiect sunt de forma:
* ''public void addActionListener(ActionListener _listener)'' - pentru evenimente de tip ''action'', adică activarea unui component (click pe un buton, enter într-un text field, etc.);
* ''public void addMouseListener(MouseListener _listener)'' - pentru evenimente legate de mouse;
* etc.

Același handler poate fi asociat mai multor elemente, iar în acest caz, pentru a știi care obiect a generat evenimentul, se folosește metoda ''getSource()'' definită în clasa '''java.util.EventObject''' care este superclasă pentru toate obiectele primite ca argumente de metode de tip handler ([http://docs.oracle.com/javase/7/docs/api/java/awt/event/ActionEvent.html java.awt.event.ActionEvent], [http://docs.oracle.com/javase/7/docs/api/java/awt/event/MouseEvent.html java.awt.event.MouseEvent], etc.). Metoda ''getSource()'' întoarce o referință de tip Object la componenta de interfață care a generat evenimentul.

Mai multe despre handler-e, în [http://docs.oracle.com/javase/tutorial/uiswing/events/index.html tutorial-ul Oracle].

=== Exemplu ===

Vom descrie un '''JFrame''' care conține două '''JLabel''', două '''JTextField''', un '''JTextArea''' și un '''JButton'''. Când se apasă butonul, cele două '''JTextField''' se vor încărca cu valorile dimensiunii '''JFrame'''-ului și se va scrie un caracter ''x'' în '''JTextArea''':
<syntaxhighlight lang="java">

import java.awt.FlowLayout;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.JTextArea;
import javax.swing.JTextField;

public class FrameTest extends JFrame implements ActionListener {

// we define the elements used in
// the frame
private JPanel mainPanel;
private JLabel xLabel;
private JLabel yLabel;
private JTextField xField;
private JTextField yField;
private JTextArea textArea;
private JButton button;

public FrameTest(String _title){
// calling the constructor for JFrame to set the title
super(_title);

// initializing the components (method is implemented below)
initComponents();

// calling pack() defined in superclass to resize the frame according to
// contents
pack();

// displaying the frame
setVisible(true);

// select the default behaviour when closing the frame by clicking
// the X button on the bar: the application will exit
setDefaultCloseOperation(EXIT_ON_CLOSE);
}

public static void main(String[] _args){
FrameTest _frame = new FrameTest("Frame Test");
}

private void initComponents() {
// setting the layout as FlowLayout
setLayout(new FlowLayout());

// creating the components

// the panel adds the components in
// a FlowLayout
mainPanel = new JPanel(new FlowLayout());
xLabel = new JLabel("X size (width):");
yLabel = new JLabel("Y size (height):");
xField = new JTextField(6); //6 columns (characters)
yField = new JTextField(6); //6 columns (characters)
textArea = new JTextArea(10, 10); //10 columns, 10 rows
button = new JButton("Click me!");

//adding components to panel
mainPanel.add(xLabel);
mainPanel.add(xField);
mainPanel.add(yLabel);
mainPanel.add(yField);
mainPanel.add(textArea);
mainPanel.add(button);

//adding scrollPane to frame
add(mainPanel);

// adding the listener to the button Component
button.addActionListener(this);
}

// this is the handler defined in the ActionListener interface
public void actionPerformed(ActionEvent _actionEvent) {
xField.setText(String.valueOf(this.getWidth()));
yField.setText(String.valueOf(this.getHeight()));
textArea.append("x");
}

}
</syntaxhighlight>

Rezultatul arată așa:

[[Fișier:testframe.png|Codul de mai sus, rulat]]

Pentru a crea frame-uri mai complexe, trebuie să folosiți alte tipuri de '''LayoutManager''', elemente de tip [http://docs.oracle.com/javase/7/docs/api/javax/swing/JScrollPane.html javax.swing.JScrollPane], sau, puteți utiliza un mediu de dezvoltare, gen [http://netbeans.org/kb/docs/java/quickstart.html Netbeans] pentru a crea în mod vizual interfața.

== JavaFX ==

JavaFX este cea mai nouă implementare a platformei de dezvoltare pentru interfețe GUI de client. Cu toate că este încă într-un stadiu incipient, are avantaje față de vechiul Swing. Versiunea 2.2, care a fost publicată pe 14 august 2012 este un pas înainte către o nouă generație de aplicații multimedia pe Internet. Conform [http://docs.oracle.com/javafx/2/overview/jfxpub-overview.htm site-ului Oracle], principalele avantaje ale JavaFX sunt:
* integrare completă cu Java SE și JDK, incepând cu versiunea 7, update 6 (7u6), ceea ce implică faptul că aplicațiile JavaFX vor putea fi dezvoltate și rulate de către orice client cu această verisune de Java;
* inițial JavaFX a fost un limbaj de scripting, dar acum Oracle pune la dispoziție un [http://docs.oracle.com/javafx/2/api/index.html API] pentru dezvoltarea aplicațiilor direct în Java, pentru un mai bun management și reutilizare a codului;
* un nou motor (engine) grafic, numit Prism, care face uz de accelerarea hardware oferită de GPU-urile moderne, precum și un nou manager de ferestre (Window Toolkit) numit Glass;
* un nou limbaj bazat pe XML, numit FXML, folosit pentru descrierea interfețelor grafice, astfel încât să nu fie nevoie de recompilarea codului la fiecare modificare;
* un nou ''engine'' multimedia, bazat pe [http://en.wikipedia.org/wiki/GStreamer GStreamer], care permite redarea de conținut multimedia;
* o componentă care poate afișa conținut web și care poate fi integrată în orice interfață grafică JavaFX;
* o serie de componente noi de interfață, precum grafice, tabele, meniuri și panouri;
* un sistem de a împacheta aplicațiile astfel încât acestea să fie livrate cu toate bibliotecile necesare execuției;
* portabilitate pe Linux, Windows și Mac OS X;

Un alt avantaj alt JavaFX spre deosebire de Swing, este faptul că aceeași aplicație poate fi rulată de sine stătător, ca applet, sau ca aplicație de tip [http://docs.oracle.com/javafx/1.3/tutorials/deploy-using-webstart/ Web Start].

În plus, orice component din JavaFX poate fi modificat ca aspect folosind directive [http://en.wikipedia.org/wiki/Cascading_Style_Sheets CSS], conform [http://docs.oracle.com/javafx/2/css_tutorial/jfxpub-css_tutorial.htm].

<div class="regula"><font color="#ff0000">Atenție:</font> În laboratorul din sala 2 de calculatoare este instalată o versiune veche de Java care nu permite dezvoltarea aplicațiilor in JavaFX.</div>

=== Componente ===

Ca și Java Swing, JavaFX se bazează pe o ierarhie de clase care implementează diferite componente și containere ce reprezintă elementele grafice. Analog clasei '''JFrame''', în JavaFX, clasa care descrie fereastra principală a unei aplicații este [http://docs.oracle.com/javafx/2/api/javafx/stage/Stage.html javafx.stage.Stage]. O aplicație JavaFX (spre deosebire de o aplicație Java obișnuită, care pornește cu metoda ''main()'') trebuie să extindă clasa [http://docs.oracle.com/javafx/2/api/javafx/application/Application.html javafx.application.Application]. Aceasta este o clasă abstractă, deci utilizatorul este obligat să definească metoda ''public void start(Stage _primaryStage)'', care este metoda de start a aplicației, analog metodei ''main()''.

Un obiect de tip '''Stage''' conține, la un moment dat, o singură scenă ([http://docs.oracle.com/javafx/2/api/javafx/scene/Scene.html javafx.scene.Scene]). Această scenă este inițializată dându-i-se dimensiunile scenei și container-ul care conține toate celălalte elemente din fereastră. Acest container este, de cele mai multe ori, un panou. Panoul, pe lângă rolul de container, specifică și modul în care sunt afișate componentele, analog '''LayoutManager'''-ului din Swing. Vom folosi, pentru exemplu, un [http://docs.oracle.com/javafx/2/api/javafx/scene/layout/FlowPane.html javafx.scene.layout.FlowPane], care este analog clasei '''FlowLayout''':
<syntaxhighlight lang="java">
import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.layout.FlowPane;
import javafx.stage.Stage;

public class JavaFXApplicationTest extends Application {

public void start(Stage _primaryStage){
// creating the pane for the elements:
FlowPane _pane = new FlowPane();

// creating the scene with the FlowPane as the
// container for all elements and dimensions
// width = 300 and height = 250 pixels
Scene scene = new Scene(_pane, 300, 250);

// setting the scene in the primary stage
primaryStage.setScene(scene);

// setting the title of the stage
primaryStage.setTitle("Empty pane");

//displaying the stage
primaryStage.show();
}

/**
* The main() method is ignored in correctly deployed JavaFX application.
* main() serves only as fallback in case the application can not be
* launched through deployment artifacts, e.g., in IDEs with limited FX
* support. NetBeans ignores main().
*/
public static void main(String[] args) {
launch(args);
}

}
</syntaxhighlight>

Rezultatul:

[[Fișier:javafx_empty.png|O scenă fără elemente în JavaFX]]

Alte componente care pot fi folosite într-un scene:
* [http://docs.oracle.com/javafx/2/api/javafx/scene/control/Label.html javafx.scene.control.Label] - analog '''JLabel'''
* [http://docs.oracle.com/javafx/2/api/javafx/scene/control/Button.html javafx.scene.control.Button] - analog '''JButton'''
* [http://docs.oracle.com/javafx/2/api/javafx/scene/control/TextField.html javafx.scene.control.TextField] - analog '''JTextField'''
* [http://docs.oracle.com/javafx/2/api/javafx/scene/control/TextArea.html javafx.scene.control.TextArea] - analog '''JTextArea'''
* [http://docs.oracle.com/javafx/2/api/javafx/scene/control/RadioButton.html javafx.scene.control.RadioButton] - analog '''JRadioButton'''
* [http://docs.oracle.com/javafx/2/api/javafx/scene/control/CheckBox.html javafx.scene.control.CheckBox] - analog '''JCheckBox'''
* [http://docs.oracle.com/javafx/2/api/javafx/scene/control/ComboBox.html javafx.scene.control.ComboBox] - analog '''JComboBox'''
* etc.

Un exemplu analog cu cel de la Swing:
<syntaxhighlight lang="java">
import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.control.TextArea;
import javafx.scene.control.TextField;
import javafx.scene.layout.FlowPane;
import javafx.stage.Stage;

public class JavaFXApplicationTest extends Application {

private Label labelx;
private Label labely;
private TextField fieldx;
private TextField fieldy;
private TextArea area;
private Button button;

public void start(Stage primaryStage) {

FlowPane _pane = new FlowPane();

//creating the components:
labelx = new Label("Width:");
labely = new Label("Height:");
fieldx = new TextField();
fieldy = new TextField();
area = new TextArea();
button = new Button("Click me!");

//adding the elements to pane:
_pane.getChildren().add(labelx);
_pane.getChildren().add(fieldx);
_pane.getChildren().add(labely);
_pane.getChildren().add(fieldy);
_pane.getChildren().add(area);
_pane.getChildren().add(button);

Scene scene = new Scene(_pane, 300, 250);

primaryStage.setTitle("Test pane");
primaryStage.setScene(scene);
primaryStage.show();
}

/**
* The main() method is ignored in correctly deployed JavaFX application.
* main() serves only as fallback in case the application can not be
* launched through deployment artifacts, e.g., in IDEs with limited FX
* support. NetBeans ignores main().
*/
public static void main(String[] args) {
launch(args);
}

}
</syntaxhighlight>

Cu rezultatul:

[[Fișier:javafx_full.png|O scenă cu diverse elemente în JavaFX]]

=== Panouri ===

Analog diferitelor tipuri de '''LayoutManager''' din Swing și JavaFX dispune de o serie de panouri:
* [http://docs.oracle.com/javafx/2/api/javafx/scene/layout/GridPane.html javafx.scene.layout.GridPane] - '''GridLayout'''
* [http://docs.oracle.com/javafx/2/api/javafx/scene/layout/StackPane.html javafx.scene.layout.StackPane] - '''CardLayout'''
* [http://docs.oracle.com/javafx/2/api/javafx/scene/layout/BorderPane.html javafx.scene.layout.BorderPane] - '''BorderLayout'''
* etc.

Tot panouri sunt și alte tipuri de elemente care în Java Swing aveau propriul tip de clasă, doar că aceste nu fac parte din pachetul '''javafx.scene.layout''' ci '''javafx.scene.control''':
* [http://docs.oracle.com/javafx/2/api/javafx/scene/control/ScrollPane.html javafx.scene.control.ScrollPane] - '''JScrollPane'''
* [http://docs.oracle.com/javafx/2/api/javafx/scene/control/SplitPane.html javafx.scene.control.SplitPane] - '''JSplitPane'''

=== Event Handlers ===

Ca și în Swing, JavaFX permite asocierea unor metode de tip ''handler'' cu declanșarea unor evenimente. Modul de conectare este foarte similar:
<syntaxhighlight lang="java">
import javafx.application.Application;
import javafx.event.ActionEvent;
import javafx.event.EventHandler;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.control.TextArea;
import javafx.scene.control.TextField;
import javafx.scene.layout.FlowPane;
import javafx.stage.Stage;

public class JavaFXApplicationTest extends Application implements EventHandler<ActionEvent>{

private Label labelx;
private Label labely;
private TextField fieldx;
private TextField fieldy;
private TextArea area;
private Button button;
private Scene scene;

public void start(Stage primaryStage) {

FlowPane _pane = new FlowPane();

//creating the components:
labelx = new Label("Width:");
labely = new Label("Height:");
fieldx = new TextField();
fieldy = new TextField();
area = new TextArea();
button = new Button("Click me!");

//adding the handler to the button
button.setOnAction(this);

//adding the elements to pane:
_pane.getChildren().add(labelx);
_pane.getChildren().add(fieldx);
_pane.getChildren().add(labely);
_pane.getChildren().add(fieldy);
_pane.getChildren().add(area);
_pane.getChildren().add(button);

scene = new Scene(_pane, 300, 250);

primaryStage.setTitle("Test pane");
primaryStage.setScene(scene);
primaryStage.show();
}

// this is the handler method defined in interface
// EventHandler
public void handle(ActionEvent _event) {
fieldx.setText(String.valueOf(scene.getWidth()));
fieldy.setText(String.valueOf(scene.getHeight()));
area.appendText("x");
}

/**
* The main() method is ignored in correctly deployed JavaFX application.
* main() serves only as fallback in case the application can not be
* launched through deployment artifacts, e.g., in IDEs with limited FX
* support. NetBeans ignores main().
*/
public static void main(String[] args) {
launch(args);
}

}
</syntaxhighlight>

Spre deosebire de Swing, unde existau mai multe tipuri de interfețe, una pentru fiecare tip de eveniment (ex: ActionListener, MouseListener, PropertyChangeListener, etc.), în JavaFX se folosește o singură interfață, [http://docs.oracle.com/javafx/2/api/javafx/event/EventHandler.html javafx.event.EventHandler] cu o singură metodă definită (''handle(T)''), unde '''T''' este un șablon folosit pentru a face diferența între diferitele tipuri de evenimente: [http://docs.oracle.com/javafx/2/api/javafx/event/ActionEvent.html javafx.event.ActionEvent], [http://docs.oracle.com/javafx/2/api/javafx/stage/WindowEvent.html javafx.stage.WindowEvent], [http://docs.oracle.com/javafx/2/api/javafx/scene/web/WebEvent.html javafx.scene.web.WebEvent], etc.

Pentru JavaFX există o aplicație care permite dezvoltarea vizuală de interfețe grafice, numită [http://www.oracle.com/technetwork/java/javafx/tools/index.html JavaFX Scene Builder].

@@ Linia 165: / Linia 165: @@
 </syntaxhighlight>
-Rezultatul arată așa:
+The GUI appears like that:
 [[Fișier:testframe.png|The execution result of the code above]]

@@ Linia 171: / Linia 171: @@
 To create more complex frames, you need use other types of '''LayoutManager''' classes, elements of type [http://docs.oracle.com/javase/7/docs/api/javax/swing/JScrollPane.html javax.swing.JScrollPane], or, you can use an integrated developing environment (IDE) like [http://netbeans.org/kb/docs/java/quickstart.html Netbeans] to visually create the interface.
 == JavaFX ==
@@ Linia 404: / Linia 405: @@
 Pentru JavaFX există o aplicație care permite dezvoltarea vizuală de interfețe grafice, numită [http://www.oracle.com/technetwork/java/javafx/tools/index.html JavaFX Scene Builder].

← Versiunea anterioară	Versiunea de la data 23 decembrie 2013 14:29
(Nicio diferență)

@@ Linia 72: / Linia 72: @@
 More about handlers in the [http://docs.oracle.com/javase/tutorial/uiswing/events/index.html Oracle tutorial].
-=== Exemplu ===
+=== Example ===
-Vom descrie un '''JFrame''' care conține două '''JLabel''', două '''JTextField''', un '''JTextArea''' și un '''JButton'''. Când se apasă butonul, cele două '''JTextField''' se vor încărca cu valorile dimensiunii '''JFrame'''-ului și se va scrie un caracter ''x'' în '''JTextArea''':
+We will write a '''JFrame''' that contains two'''JLabel''', two '''JTextField''', one '''JTextArea''' and one '''JButton'''. When the button is pressed, the two text fields will be loaded with the dimensions of the frame and an 'x' character will be appended to the text area:
 <syntaxhighlight lang="java">
@@ Linia 166: / Linia 167: @@
 Rezultatul arată așa:
-[[Fișier:testframe.png|Codul de mai sus, rulat]]
+[[Fișier:testframe.png|The execution result of the code above]]
-Pentru a crea frame-uri mai complexe, trebuie să folosiți alte tipuri de '''LayoutManager''', elemente de tip [http://docs.oracle.com/javase/7/docs/api/javax/swing/JScrollPane.html javax.swing.JScrollPane], sau, puteți utiliza un mediu de dezvoltare, gen [http://netbeans.org/kb/docs/java/quickstart.html Netbeans] pentru a crea în mod vizual interfața.
+To create more complex frames, you need use other types of '''LayoutManager''' classes, elements of type [http://docs.oracle.com/javase/7/docs/api/javax/swing/JScrollPane.html javax.swing.JScrollPane], or, you can use an integrated developing environment (IDE) like [http://netbeans.org/kb/docs/java/quickstart.html Netbeans] to visually create the interface.
 == JavaFX ==

@@ Linia 63: / Linia 63: @@
 === Event Handlers ===
-Fiecare '''JComponent''' suportă o listă de evenimente la care e sensibil. Fiecărui eveniment i se poate asociaza o acțiune care se execută când acel eveniment se declanșează. De exemplu, când un buton este apăsat, sau când cursorul de la mouse a intrat în zona ocupată de componentă, sau când s-a tastat ceva într-o zonă de text, etc. Aceste ''handler''-e sunt, de fapt, niște metode, definite în anumite interfețe. Aceste metode se excută în paralel cu programul principal (ca și thread-uri) în momentul în care evenimentul se declanșează. Metodele care adaugă un ''handler'' unui obiect sunt de forma:
+Every '''JComponent''' supports a list of events which it is sensitive to. To each event, an action can be associated which is executed when that event is triggered. For example, then a button is pressed, or when the mouse moves over the component, or when something is typed in a text component, etc. These handlers are, in fact, methods, defined in certain interfaces. These methods are executed in parallel with the main program, as threads, in the moment when the event is triggered. Methods that add a handled to a component look like this:
-* ''public void addActionListener(ActionListener _listener)'' - pentru evenimente de tip ''action'', adică activarea unui component (click pe un buton, enter într-un text field, etc.);
+* ''public void addActionListener(ActionListener _listener)'' - for ''action'' type events, meaning activating a component (like click on a button, writing a text in a text field, etc.);
-* ''public void addMouseListener(MouseListener _listener)'' - pentru evenimente legate de mouse;
+* ''public void addMouseListener(MouseListener _listener)'' - for events related to the mouse;
 * etc.
-Același handler poate fi asociat mai multor elemente, iar în acest caz, pentru a știi care obiect a generat evenimentul, se folosește metoda ''getSource()'' definită în clasa '''java.util.EventObject''' care este superclasă pentru toate obiectele primite ca argumente de metode de tip handler ([http://docs.oracle.com/javase/7/docs/api/java/awt/event/ActionEvent.html java.awt.event.ActionEvent], [http://docs.oracle.com/javase/7/docs/api/java/awt/event/MouseEvent.html java.awt.event.MouseEvent], etc.). Metoda ''getSource()'' întoarce o referință de tip Object la componenta de interfață care a generat evenimentul.
+The same handler can be associated to multiple elements, in which case, in order to know which element triggered the event, the method ''getSource()'' is used, defined in class '''java.util.EventObject''' which is the superclass for all objects received as arguments by handler methods ([http://docs.oracle.com/javase/7/docs/api/java/awt/event/ActionEvent.html java.awt.event.ActionEvent], [http://docs.oracle.com/javase/7/docs/api/java/awt/event/MouseEvent.html java.awt.event.MouseEvent], etc.). Method ''getSource()'' returns a reference of type Object to the component that generated the event.
-Mai multe despre handler-e, în [http://docs.oracle.com/javase/tutorial/uiswing/events/index.html tutorial-ul Oracle].
+More about handlers in the [http://docs.oracle.com/javase/tutorial/uiswing/events/index.html Oracle tutorial].
 === Exemplu ===

@@ Linia 40: / Linia 40: @@
 O altă serie de clase necesară pentru implementarea unei interfețe grafice este setul de clase care extind interfața [http://docs.oracle.com/javase/7/docs/api/java/awt/LayoutManager.html java.awt.LayoutManager]. Aceste clase descriu modul în care elementele se așează într-un '''Container'''. Cele mai importante sunt:
 ==== [http://docs.oracle.com/javase/7/docs/api/java/awt/FlowLayout.html java.awt.FlowLayout] ====
-'''FlowLayout''' este utilizat pentru a așseza elementele pe orizontală, până când nu mai încap, în care situație se trece pe rândul următor. Acesta este cel mai simplu tip de layout.
+'''FlowLayout''' is used to place elements horizontally, until they don't fit anymore, in which case, subsequent components are placed on the next line. This is the simplest type of layout.
 ==== [http://docs.oracle.com/javase/7/docs/api/java/awt/GridLayout.html java.awt.GridLayout] ====
-'''GridLayout''' este utilizat pentru a așseza elementele într-o matrice cu număr configurabil de linii și coloane.
+'''GridLayout''' is used to place components in a matrix with configurable size.
 ==== [http://docs.oracle.com/javase/7/docs/api/java/awt/BorderLayout.html java.awt.BorderLayout] ====
-'''BorderLayout''' este utilizat pentru a așseza elementele dealungul celor patru margini și în centru, adică NORTH, SOUTH, EAST, WEST și CENTER. Un singur element poate fi plasat în fiecare din aceste poziții.
+'''BorderLayout''' is used to place elements along the four borders and in center: NORTH, SOUTH, EAST, WEST and CENTER. Only one element can be placed in either of the five positions.
 ==== [http://docs.oracle.com/javase/7/docs/api/java/awt/CardLayout.html java.awt.CardLayout] ====
-'''CardLayout''' este utilizat pentru a adăuga mai multe componente unui '''Container''' din care doar unul este vizibil la un moment dat. Acest tip de ''layout'' este util pentru generarea de aplicații tip ''wizard'' în care utilizatorul trece de la o fereastră la alta cu ajutorul unor butoane ''Next'' și ''Previous''.
+'''CardLayout''' is used to add more components to a container, from which only one is visible at any given time. This type of layout is useful to generate wizard type applications in which the user skips from one screen to the next and back by using ''Next'' and ''Previous'' buttons.
-Mai multe despre elemente de tip Layout, în [http://docs.oracle.com/javase/tutorial/uiswing/layout/visual.html tutorial-ul Oracle].
+More about layouts in the [http://docs.oracle.com/javase/tutorial/uiswing/layout/visual.html Oracle tutorial].
 === Event Handlers ===

@@ Linia 19: / Linia 19: @@
 ==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JPanel.html javax.swing.JPanel] ====
-'''JPanel''' este un container generic care poate conține alte elemente. Poate fi vizibil, schimbându-i-se culoarea background-ului, sau modelul marginii, sau invizibil, folosit doar pentru ierarhizarea conținutului. Este indicat să nu plasați alte obiecte direct pe un '''JFrame''', ci doar un '''JPanel''' care să conțină restul de elemente. Acest lucru este foarte util și când aveți nevoie să schimbați complet elementele dintr-un '''JFrame''', înlocuiți doar '''JPanel'''-ul.
+'''JPanel''' is a generic container that can hold other elements. It can be visible, changing the background color, the image model or having a border, or be invisible, only used for the hierarchy of the content. It is recommended not to place elements directly in a JFrame, but in a JPanel that is placed in a JFrame. This is particularly useful when reusing a panel.
 ==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JLabel.html javax.swing.JLabel] ====
-'''JLabel''' este un component utilizat pentru a afișa text sau imagini într-un container.
+'''JLabel''' is a component used to display text or image in a container.
 ==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JButton.html javax.swing.JButton] ====
-'''JButton''' este, cum îi spune și numele, un buton. Acesta poate avea afișat un text sau o imagine. De cele mai multe ori este utilizat asociindu-i-se un ''Event Handler'' de tip ''ActionListener'' (vezi [[#Event Handlers]]) care se declanșează când acesta este apăsat (se dă click pe el).
+'''JButton''' is, as the name says, a button. This can have either a text or an image displayed on top. It's used by specifying an event handler of type ''ActionListener'' (see [[#Event Handlers]]) which is triggered when the button is clicked.
 ==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JTextField.html javax.swing.JTextField] ====
-'''JTextField''' reprezintă o zonă în care se poate introduce text scurt, de o singură linie. Și acestul element i se poate asocia un ''Event Handler'' de tip ''ActionListener'' care se declanșează când se apasă tasta ''Enter'' în zona de editare.
+'''JTextField''' is an area where a short text can be entered, on a single line. This too can have an associated event handler of type ''ActionListener'' which is triggered when ''Enter'' is pressed when the text field is focused.
 ==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JTextArea.html javax.swing.JTextArea] ====
-'''JTextArea''' reprezintă o zonă în care se poate introduce text de mai multe linii.
+'''JTextArea''' is a component where you can add a large text on more than one line.
 === Layouts ===

@@ Linia 15: / Linia 15: @@
 === Components ===
-Toate obiectele Swing, cu excepția clasei '''JFrame''', moștenesc clasa [http://docs.oracle.com/javase/7/docs/api/javax/swing/JComponent.html javax.swing.JComponent], care la rândul ei moștenește (indirect) clasa [http://docs.oracle.com/javase/7/docs/api/java/awt/Container.html java.awt.Container]. Astfel, se creează o ierarhie de componente, fiecare element (numit ''parent'') înglobând alte sub-componente (numite ''children''). În continuare se vor prezenta elementele necesare realizării temei 6. Pentru descrierea altor elemente mai avansate, citiți [http://docs.oracle.com/javase/tutorial/uiswing/components/index.html tutorial-ul Oracle].
+All Swing objects, with the exception of class '''JFrame''', inherit class [http://docs.oracle.com/javase/7/docs/api/javax/swing/JComponent.html javax.swing.JComponent] which in turn inherits (indirectly) class [http://docs.oracle.com/javase/7/docs/api/java/awt/Container.html java.awt.Container]. So, there is a hierarchy of components, each element called parent containing other sub-components called children. Next, we'll present the elements required for task 6. For a more detailed description, read [http://docs.oracle.com/javase/tutorial/uiswing/components/index.html the Oracle tutorial].
 ==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JPanel.html javax.swing.JPanel] ====
@@ Linia 35: / Linia 35: @@
 ==== [http://docs.oracle.com/javase/7/docs/api/javax/swing/JTextArea.html javax.swing.JTextArea] ====
 '''JTextArea''' reprezintă o zonă în care se poate introduce text de mai multe linii.
 === Layouts ===

@@ Linia 1: / Linia 1: @@
-În multe dintre aplicațiile pe care le veți dezvolta folosing Java, veți avea nevoie și de o interfață grafică adecvată: ferestre, butoane, câmpuri de editare, checkboxuri, etc. Există mai multe biblioteci de dezvoltare pentru interfețe grafice, cea mai cunoscută fiind [http://docs.oracle.com/javase/tutorial/ui/overview/index.html Java Swing] și cea mai nouă fiind [http://docs.oracle.com/javafx/index.html JavaFX].
+In many of the applications that you will develop in Java, you will also need an adequate graphical interface: windows, buttons, edit fields, checkboxes, etc. There are several libraries used for developing graphical interfaces, the most popular being [http://docs.oracle.com/javase/tutorial/ui/overview/index.html Java Swing] and the most recent being [http://docs.oracle.com/javafx/index.html JavaFX].
 == Java Swing ==
-Pachetul care conține majoritatea claselor pentru aplicațiile Swing este [http://docs.oracle.com/javase/7/docs/api/javax/swing/package-summary.html java.swing] dar sunt utilizate și multe din clasele din vechea biblotecă GUI, [http://docs.oracle.com/javase/7/docs/api/java/awt/package-summary.html java.awt]. Clasa principală pentru aplicații Java Swing este clasa [http://docs.oracle.com/javase/7/docs/api/javax/swing/JFrame.html javax.swing.JFrame].
+The package that contains the majority of classes for Swing applications is [http://docs.oracle.com/javase/7/docs/api/javax/swing/package-summary.html java.swing], some other other classes are used from the older package [http://docs.oracle.com/javase/7/docs/api/java/awt/package-summary.html java.awt]. The main container class for GUI elements is [http://docs.oracle.com/javase/7/docs/api/javax/swing/JFrame.html javax.swing.JFrame].
-Frame-ul este fereastra principală a unei interfețe grafice. Este elementul care are asociată bara de deasupra, care conține icon-ul, numele aplicației și cele trei butoane: minimize, maximize, close:
+The Frame is the main window of the GUI. It's the element associated with the horizontal bar containing the icon, application name and the three buttons minimize, maximize and close:
 [[Fișier:emptyframe.png|Exemplu de frame fără elemente]]
-În continuare este prezentat un frame ce conține cele mai utilizate componente Swing:
+This is a JFrame containing the most used elements in Swing:
 [[Fișier:fullframe.png|Exemplu de frame cu elemente]]
-=== Componente ===
+=== Components ===
 Toate obiectele Swing, cu excepția clasei '''JFrame''', moștenesc clasa [http://docs.oracle.com/javase/7/docs/api/javax/swing/JComponent.html javax.swing.JComponent], care la rândul ei moștenește (indirect) clasa [http://docs.oracle.com/javase/7/docs/api/java/awt/Container.html java.awt.Container]. Astfel, se creează o ierarhie de componente, fiecare element (numit ''parent'') înglobând alte sub-componente (numite ''children''). În continuare se vor prezenta elementele necesare realizării temei 6. Pentru descrierea altor elemente mai avansate, citiți [http://docs.oracle.com/javase/tutorial/uiswing/components/index.html tutorial-ul Oracle].

Graphical User Interface (GUI) - Java Swing - Revizia istoricului

Zhascsi: /* Example */

Rhobincu: a redenumit Graphical User Interface (GUI) - Java Swing and JavaFX în Graphical User Interface (GUI) - Java Swing

Rhobincu: /* JavaFX */

Rhobincu: /* Exemplu */

Rhobincu: /* Event Handlers */

Rhobincu: /* Layouts */

Rhobincu: /* Components */

Rhobincu: /* Components */

Rhobincu la 23 decembrie 2013 13:53

Rhobincu: Pagină nouă: În multe dintre aplicațiile pe care le veți dezvolta folosing Java, veți avea nevoie și de o interfață grafică adecvată: ferestre, butoane, câmpuri de editare, checkbox­uri...

Rhobincu: Pagină nouă: În multe dintre aplicațiile pe care le veți dezvolta folosing Java, veți avea nevoie și de o interfață grafică adecvată: ferestre, butoane, câmpuri de editare, checkboxuri...