Statistics
| Revision:

root / trunk / frameworks / _fwAndami / src / com / iver / andami / ui / mdiManager / MDIManager.java @ 598

History | View | Annotate | Download (2.85 KB)

1
package com.iver.andami.ui.mdiManager;
2

    
3
import com.iver.andami.ui.mdiFrame.MDIFrame;
4

    
5

    
6
/**
7
 * Las vistas que se a?aden al framework derivan de JPanel. ?Como pasamos de un
8
 * JPanel al control que vemos (habitualmente un JInternalFrame) Mediante la
9
 * clase skin que implementa esta interfaz. El framework  invoca los m?todos
10
 * de la clase pasando como par?metros jPanel y la clase toma el JPanel, lo
11
 * trata (en la version por defecto lo mete en un JInternalFrame) y lo a?ade
12
 * al Frame principal. Para poner un ejemplo se podr?a implementar ua clase
13
 * que situara los jpanel en la forma que lo hace eclipse, o instalar un men?
14
 * por cada vista de forma que al seleccionar el men?  desapareciera la vista
15
 * actual y se mostrara la que  se ha seleccionado, ...     Actualmente la
16
 * clase que implementa esta interfaz es Skin y se usa a pi??n fijo, pero en
17
 * un futuro se dejar? abierta la posibilidad de sustituir esta clase por una
18
 * que  implemente el usuario.
19
 *
20
 * @author Fernando Gonz?lez Cort?s
21
 */
22
public interface MDIManager {
23
    /**
24
     * Inicializaci?n de la clase, se le pasa la consola para mostrar mensajes
25
     * y el frame principal para actuar sobre ?l
26
     *
27
     * @param f DOCUMENT ME!
28
     */
29
    public void init(MDIFrame f);
30

    
31
    /**
32
     * A?ade una nueva vista a la interfaz y lo visualiza. Dicho vista se
33
     * elimina completamente al cerrarse.
34
     *
35
     * @param p Panel con los controles de la vista
36
     *
37
     * @return Devuelve la vista a?adida o si es un singleton y ya estaba
38
     *         a?adida devuelve la vista ya a?adida
39
     *
40
     * @throws SingletonDialogAlreadyShownException Si lo que se est? a?adiendo
41
     *         es una vista modal singleton y ya est? a?adida
42
     */
43
    public View addView(View p) throws SingletonDialogAlreadyShownException;
44

    
45
    /**
46
     * Obtiene una referencia al panel de la ultima vista no modal que se
47
     * activ? en la aplicaci?n.
48
     *
49
     * @return referencia al panel activo o null si no hay ninguna vista activa
50
     */
51
    public View getActiveView();
52

    
53
    /**
54
     * Cierra la vista correspondiente con el JPanel
55
     *
56
     * @param p vista que se quiere cerrar
57
     */
58
    public void closeView(View p);
59

    
60
    /**
61
     * Cierra todas las vistas que actualmente est?n abiertas
62
     */
63
    public void closeAllViews();
64

    
65
    /**
66
     * Obtiene la referencia al objeto que contiene la informaci?n de la
67
     * vista que se pasa como par?metro
68
     *
69
     * @param v vista cuya informaci?n se requiere
70
     *
71
     * @return ViewInfo
72
     */
73
    public ViewInfo getViewInfo(View v);
74

    
75
    /**
76
     * Pone como icono de rat?n el HourGlass y bloquea todos los eventos de
77
     * la interfaz que se producen hasta que se recibe una llamada a restoreCursor
78
     */
79
    public void setWaitCursor();
80

    
81
    /**
82
     * Restaura al icono de rat?n que hab?a antes de realizar la operaci?n
83
     */
84
    public void restoreCursor();
85
}