4. Módulo commonsdialog¶
4.1. Funciones principales¶
-
msgbox
(message[, title="", meesageType=IDEA, root=None])¶ Shows a message dialog with ok button only.
Parámetros: - message (str) – text to present in the dialog
- title (str) – title of the dialog
- messageType (int) – type of icon to use.
- root (DefaultFrame or None) – Frame reference
-
inputbox
(message[, title="", messageType=IDEA, initialValue="", root=None])¶ Shows a input dialog.
Parámetros: - message (str) – text to present in the dialog
- title (str) – title of the dialog
- messageType (int) – type of icon to use.
- initialValue (str) – Initial value of the inputbox
- root (DefaultFrame or None) – Frame reference
Devuelve: Return text in the input box
Tipo del valor devuelto: str
-
confirmDialog
(message[, title="", optionType=YES_NO, messageType=IDEA, root=None])¶ Create a message dialog with options button
Parámetros: - message (str) – text to present in the dialog
- title (str) – title of the dialog
- optionType (int) – bottons to show
- messageType (int) – type of icon to use.
-
filechooser
(option[, title="", initialPath=None, multiselection=False, filter = None, fileHidingEnabled=True, root=None])¶ - Allows configuration parameters to filechooser dialogs
Parámetros: - option (int) – file chooser selection mode. Allowed values: OPEN_FILE, OPEN_DIRECTORY, SAVE_FILE
- title (str) – Window title
- initialPath (str) – Initial path to the directory to open in the dialog
- multiselection (boolean) – Allow select more than one object.
- filter (List of Strings) – list of acepted extension files (“jpg”, “png”, “gif”)
- fileHidingEnabled (boolean) – True if hidden files are not displayed
Devuelve: Selected path or list of paths
-
openFileDialog
([title='', initialPath=None, root=None])¶ - Shows a window dialog to choose one file.
Parámetros: - title (str) – Window title. Default ‘’
- initialPath (str) – Initial path to open in window dialog
-
openFolderDialog
([title='', initialPath=None, root=None])¶ Shows a window dialog to choose one folder.
Parámetros: - title (str) – Window title. Default ‘’
- initialPath (str) – Initial path to open in window dialog
-
saveFileDialog
([title='', initialPath=None, root=None])¶ Shows a window dialog to choose one file.
Parámetros: - title (str) – Window title. Default ‘’
- initialPath (str) – Initial path to open in window dialog
-
getJavaFile
(path)¶ Returns a java File using parameter path. If path doesn’t exists looks for user home folder and if can not find it, returns path will be gvSIG instance directory.
Parámetros: path (str) – String-path. Devuelve: Return java.io.File
4.2. Constantes en la librería¶
Constantes que aparecen en la librería y usaremos en diferentes funciones:
*messageType options*
FORBIDEN = 0
IDEA= 1
WARNING= 2
QUESTION= 3
*Confirmdialog optionType Options*
YES_NO = 0
YES_NO_CANCEL = 1
ACEPT_CANCEL = 2
YES = 0
NO = 1
CANCEL = 2
*filechooser options*
OPEN_FILE = 0
OPEN_DIRECTORY = 1
SAVE_FILE = 2
*filechooser selectionMode*
FILES_ONLY = JFileChooser.FILES_ONLY
DIRECTORIES_ONLY = JFileChooser.DIRECTORIES_ONLY
4.3. Uso¶
En el módulo de commonsdialog gestiona las ventanas emergentes que aparecen en gvSIG. Por ejemplo, si queremos mostrar un avisa al usuario usaremos msgbox()
: o si queremos preguntar por algún valor al usuario que ejecute el script, podemos usar la función inputbox()
la cual devolverá el texto que escriba el usuario en la caja de texto que aparecerá en pantalla.
Para importar la librería lo haremos mediante:
import gvsig.commonsdialog
o:
from gvsig import commonsdialog
o:
from gvsig.commonsdialog import *
Por ejemplo:
1 2 3 4 5 | from gvsig import commonsdialog
def main(*args):
commonsdialog.msgbox("Bienvenido a gvSig","Welcome", commonsdialog.IDEA)
|
El tipo de mensaje lo establecemos en el parámetro messageType
como podemos ver en msgbox()
y estos tipos se encuentran almacenados en constantes dentro del módulo commonsdialog
.
O depende de cómo lo importemos.
1 2 3 4 5 | from gvsig.commonsdialog import *
def main(*args):
msgbox("Bienvenido a gvSIG", "Welcome", IDEA)
|
Dando como resultado una ventana:
![../../../_images/commonsdialog-msgbox_1.png](../../../_images/commonsdialog-msgbox_1.png)
Depende del tipo de aviso que seleccionemos mostrará diferentes iconos en la ventana:
WARNING:
![../../../_images/commonsdialog-msgbox_2.png](../../../_images/commonsdialog-msgbox_2.png)
FORBIDEN:
![../../../_images/commonsdialog-msgbox_3.png](../../../_images/commonsdialog-msgbox_3.png)
QUESTION:
![../../../_images/commonsdialog-msgbox_4.png](../../../_images/commonsdialog-msgbox_4.png)
4.4. Tipos de diálogos¶
Diferentes tipos de diálogos:
from gvsig import *
from gvsig import commonsdialog
from gvsig.commonsdialog import *
def main(*args):
message = "Prueba"
mb = commonsdialog.msgbox(message, title="", messageType=IDEA, root=None)
print "msgbox:", mb
ib = commonsdialog.inputbox(message, title="", messageType=IDEA, initialValue="", root=None)
print "inputbox:", ib
cd = commonsdialog.confirmDialog(message, title="", optionType=YES_NO, messageType=IDEA, root=None)
print "confirmDialog:", cd
option = "OPEN_FILE"
fc = commonsdialog.filechooser(option, title="", initialPath=None, multiselection=False, filter = None, fileHidingEnabled=True, root=None)
print "filechooser:", fc
fc = commonsdialog.filechooser(option, title="", initialPath=None, multiselection=True, filter = None, fileHidingEnabled=True, root=None)
print "filechooser:", fc
ofiled = commonsdialog.openFileDialog(title='', initialPath=None, root=None)
print "openFileDialog:", ofiled
ofolderd = commonsdialog.openFolderDialog(title='', initialPath=None, root=None)
print "openFolderDialog:", ofolderd
sfd = commonsdialog.saveFileDialog(title='', initialPath=None, root=None)
print "saveFileDialog:",sfd
Msgbox:
![../../../_images/c_msgbox.png](../../../_images/c_msgbox.png)
Inputbox:
![../../../_images/c_inputbox.png](../../../_images/c_inputbox.png)
Confirm Dialog:
![../../../_images/c_confirmDialog.png](../../../_images/c_confirmDialog.png)
File chooser:
![../../../_images/c_1.png](../../../_images/c_1.png)
File chooser with multiselection:
![../../../_images/c_2.png](../../../_images/c_2.png)
Open file dialog:
![../../../_images/c_3.png](../../../_images/c_3.png)
Open folder dialog:
![../../../_images/c_4.png](../../../_images/c_4.png)
Save file dialog:
![../../../_images/c_5.png](../../../_images/c_5.png)
Salida por consola:
msgbox: None
inputbox:
confirmDialog: 0
filechooser: D:\gvdata\countries027.geojson
filechooser: [u'D:\\gvdata\\countries024.geojson', u'D:\\gvdata\\countries025.geojson', u'D:\\gvdata\\countries026.geojson',
u'D:\\gvdata\\countries027.geojson', u'D:\\gvdata\\countries028.geojson', u'D:\\gvdata\\countries029.geojson',
u'D:\\gvdata\\countries030.geojson']
openFileDialog: [u'D:\\gvdata\\countries028.geojson']
openFolderDialog: [u'D:\\gvdata\\GISofThrones\\GoTRelease']
saveFileDialog: [u'D:\\gvdata\\newfile.shp']