PYTHON ADD-INS

El objetivo es que el
participante aprenda a
crear su propia barra
de herramientas con
Python
Tipos de add in

Button Un botón es la forma más simple de funcionalidad que se

puede utilizar para ejecutar alguna lógica de negocios.
Al hacer clic en el botón asume que una acción o una serie
de acciones se ejecutarán.

Tool
Una herramienta es muy similar a un botón. Sin embargo, la
herramienta requiere primero la interacción del usuario con la
pantalla de la aplicación de escritorio y, dependiendo de esa
interacción, ejecuta alguna lógica de negocios.
 Tipos de add in

Un cuadro combinado proporciona un conjunto de opciones,

visualmente es un cuadro desplegable, que se pueden
Combo Box
seleccionar y actuar sobre ellas. Un cuadro combinado
también se puede habilitar para permitir que un usuario final
agregue un valor en el cuadro combinado.

Menu
Un menú es un contenedor para botones u otros menús.

Toolbar
Una barra de herramientas es un contenedor para los botones, herramientas,
cuadros combinados, paletas de herramientas y los menús.
Funciones Python Add In
OpenDialog({title}, {multiple_selection}, {starting_location}, {button_caption}, {filter}, {filter_label})
Abre un cuadro de diálogo para elegir uno o más datasets SIG.
{title}: título del cuadro de diálogo.
{multiple_selection}: indica si se pueden seleccionar varios elementos. Es falso, por defecto.
{starting_location}: ruta a la ubicación de inicio.
{button_caption}: título para el botón Abrir.
{filter}: un argumento del filtro que se puede llamar. La rutina que se puede llamar toma un argumento simple, una ruta de
catálogo a un elemento seleccionado, y devuelve verdadero o falso dependiendo de si el elemento puede abrirse o no.
{filter_label}: es el texto que se ve en el cuadro desplegable Mostrar tipo: del cuadro de diálogo.

#Abrir un espacio de trabajo

import pythonaddins
ruta=r"C:\Users\Richard\Documents\Taller Python para ArcGIS\SHP"
pythonaddins.OpenDialog("Carpeta SHP",True,ruta,"Adicionar SHP")
 Funciones Python Add In
SaveDialog({title}, {name_text}, {starting_location}, {filter}, {filter_label})

Abre un cuadro de diálogo para guardar los datos. Esta función muestra la ruta completa del dataset que se va a guardar.
{title}: título del cuadro de diálogo.
{name_text}: el nombre del dataset que se muestra en el cuadro de texto del nombre del cuadro de diálogo.
{starting_location}: la ruta a la ubicación de inicio en la que se guardarán los datos.
{filter}: un argumento del filtro que se puede llamar. La rutina que se puede llamar acepta un argumento simple, una ruta de
catálogo a un elemento seleccionado, y devuelve verdadero o falso dependiendo de si el elemento puede guardarse o no.
{filter_label}: es el texto que se ve en el cuadro desplegable Mostrar tipo: del cuadro de diálogo.

#Ventana para Guardar

import pythonaddins
ruta=r"C:\Users\Richard\Documents\Taller Python para ArcGIS\Reportes"
pythonaddins.SaveDialog("Guardar Reporte del curso","reporte.xls",ruta)
 Funciones Python Add In
GPToolDialog(toolbox, tool_name)

Abre un cuadro de diálogo de la herramienta de geoprocesamiento.

{toolbox}: ubicación de la caja de herramientas.
{tool_name}: nombre de la herramienta.

#Abrir una herramienta

import pythonaddins
ruta=r'C:\Users\Richard\Documents\Taller Python para ArcGIS\Herramienta\Toolbox.tbx'
pythonaddins.GPToolDialog(ruta, 'ScriptBuffer')
 Funciones Python Add In mb_type value
MessageBox(message, title, {mb_type}) 0 Aceptar

1 OK/Cancelar
Muestra un cuadro de mensaje.
message: el mensaje que se va a mostrar. 2 Interrumpir/volver a intentar/ignorar
title: el título del cuadro de mensaje.
3 Sí/No/Cancelar
{mb_type}: el tipo de cuadro de mensaje que se va mostrar. La opción
predeterminada es 0 (mensaje Aceptar). 4 Sí/No

5 Volver a intentar/Cancelar

6 Cancelar/Volver a intentar/Continuar

#Mensaje
import pythonaddins
pythonaddins.MessageBox("Curso Python para ArcGIS", "Bienvenido Richard Flores", 0)
Funciones Python Add In
Propiedades
ProgressDialog() animation Los valores válidos son None, "File", "Spiral"

Devuelve un objeto ProgressDialog, este objeto se visualiza description Descripción larga

automáticamente cuando entra en el bloque with y desaparece
title Título de diálogo
cuando sale de él.
cancelled Devuelve verdadero si se pulsa el botón Cancelar

canCancel Habilita o deshabilita el botón Cancelar

progress Número entre 1 y 100 que representa el progreso de la barra

import pythonaddins
with pythonaddins.ProgressDialog as dialog:
dialog.title = "Copiando"
dialog.description = "Copiando archivo espacial"
dialog.animation = "File"
for i in xrange(100):
dialog.progress = i
time.sleep(0.125)
if dialog.cancelled:
raise Exception("Ooops")
 Dirección para descargar Python Add-In Wizard:

https://www.arcgis.com/home/item.html?id=5f3aefe77f6b4f61ad3e4c62f30bff3b

En la barra de direcciones escribir:

Seleccionar:
1 Desempaquetar 2 Doble clic en addin_assistant.exe 3 Ejecutar:
:
4 Crear carpeta donde se va a generar el instalador: 5 Rellenar campos y guardar:
6 Pestaña Add-In Contens, seleccionar TOOLBARS y
dar clic derecho: 7 Dar un título a la barra de herramienta:
8 Clic derecho en la barra de herramienta creada y 9 Rellenar campos del botón, guardar y abrir la
seleccionar New Button: carpeta:
10 Doble clic en makeaddin.py 11 Doble clic en Herramienta.esriaddin 12 Instalar Add-In

14 Verificar en ArcMap:
13 Instalación satisfactoria:
Práctica
Práctica
Funcionalidades
BIBLIOTECAS A CONSIDERAR
Funcionalidades
MENU: Botón 01
Funcionalidades
MENU: Botón 02
Funcionalidades
BOTONES: Botón 01
Funcionalidades
BOTONES: Botón 02
Funcionalidades

PALETA DE HERRAMIENTAS: Herramienta 01 self.cursor

Funcionalidades
PALETA DE HERRAMIENTAS: Herramienta 02
Funcionalidades
CUADRO COMBINADO