201 Avenue Scripts

Abstract

Introduction

Most of these scripts are appropriate for use in customized ArcView applications where there is a need for tight control over functionality. Customized applications focus on well defined user needs and include special menus, buttons, and tools that replace the basic functionality that comes with ArcView out-of-the-box. Below is a simple example of a customized application called View Base Map. This application opens a view that displays base map information anywhere in the State of Connecticut either as a set of feature themes (shown below) or as a seamless image theme of tiled USGS Digital Raster Graphic files. People using the application turn on the type of base they want to see, pan to known geographic locations, identify features, and print base maps for any Connecticut town or 7.5 minute quadrangle from a menu. The View Base Map application uses many of the 201 Scripts. For example, each of the five tools in the tool menu shown below runs the zView.ThemeIdentifyTool script, which identifies a theme without forcing the user to make the theme active beforehand. There is a separate tool for identifying roads, railroads, lakes, stream polygons and single line streams.

How to use the scripts

Each script comes with a header that describes what the script does and how to use it in ArcView. Pay close attention to the Function, Parameters, Requires, and Desc header elements because they usually include everything you need to know. Headers for control update scripts are smaller in scope because these scripts tend to be very short and easy to understand.

Modular scripts

zView.ThemeIdentifyTool

' Name        zView.ThemeIdentifyTool
' File        zViewThemeIdentifyTool.txt
' Application
' Function    Identifies theme features 
' Parameters  theThemeName,theFieldName,theIdWinSizeX,theIdWinSizeY
' Returns     NIL upon error
' Called by
' Calls to
' Requires
' Variables
' History     1-99 Howie Sternberg, State of Connecticut, DEP
' Version     3.1
' Desc        An apply event script for a Tool control in a View DocGUI that
' identifies theme features and lists a field value for them in the left hand
' side of the Identify window. Four parameters (theThemeName,theFieldName,
' theWinIdSizeX,theWindIdSizeY) specify the theme name, the id field name, 
' and the x and y pixel dimension of the identify window.  These parameters
' are passed as the control's tag property and MUST be separated by commas
' with no spaces in between.
	
'             Apply:  zView.ThemeIdentifyTool
'             Tag:    Towns,Town_no,400,200
'             Update: zView.ThemeTagUpdateVisThresh100

How to use zView.ThemeIdentifyTool

1. Add the zView.ThemeIdentifyTool script to the project.
2. Compile the script.
3. Go to Project > Customize... and open the Customize Window.
4. Since zView.ThemeIdentifyTool is an apply event script for a tool control in a View DocGUI, set the Type: to View and the Category: to Tools, as shown above.
5. To add a new tool, press the Separator button and then press the Tool button.
6. Make sure the new tool is selected. Double click in the empty Apply property cell and select the zView.ThemeIdentifyTool script from the list of scripts that opens.
7. Double click in the empty Tag property cell and enter a comma separated string that includes the name of the theme, the name of the field to list on the left side of the identify results window, the pixel width, and the pixel height of the identify results window.

Non-modular scripts

These customizable, non-modular scripts add themes, delete themes, and print special types of maps. They include zView.ThemeAdd, zView.ThemeSetAdd, zViewThemeSetDelete, zViewImageThemeAdd, and zView.MapAndReport.

zView.MapAndReport is a non-modular script that prints a map centered on the current view along with a separate report listing features on the map. It labels themes so features are labeled on the map, prints the map, prints an accompanying report listing features on the map, and deletes the labels from the view when done. This script includes a few lists that need to be populated with the names of the themes and fields to label and print in the report. Below is the header portion of the script, followed by the section that includes the lists. Note that zView.MapAndReport is a button or menu click event driver script for a view DocGUI that calls other scripts. It passes these lists to the called scripts so that they know how to label the themes, print the map, print the report, and remove the labels.

' Name        zView.MapAndReport
' File        zViewMapAndReport.txt
' Application 
' Function    Driver script for printing a map and accompanying report listing features on map
' Parameters
' Returns     NIL upon error
' Called by
' Calls to    zView.MapAndReportMakeMap, zView.MapAndReportMakeReport, 
'             zView.MapAndReportLabelAdd, zView.MapAndReportLabelDelete
' Requires    Active view with map units set
' Variables     
' History     1-99 Howie Sternberg, State of Connecticut, DEP
' Version     3.1
' Desc        A click event script for a Menu or Button control in a View DocGUI
' that prints a map and accompanying report of attribute information for the 
' features appearing on the map.  This script is a driver script that calls other
' scripts for adding theme labels, deleting theme labels, printing the map, and
' printing the report. These scripts present a series of message and dialog boxes
' for specifying the printer for the map, the printer for the report, and whether
' to preview the map before printing, etc.  Different printers and page sizes can
' be specified for the map and report.

'             Click:  zView.MapAndReport
'             Tag:   
'             Update: 

' Edit the following 5 sections before running this script 

' --------------------- Edit Here ------------------------

' 1  Make list of themes to label on the map

' {theThemeName,theFieldName,theTextFamily,theTextStyle,theTextColor,theTextSize,theDupFlag}

theLabelThemes = list.make
theLabelThemes.Add({"Avtown.shp","Town","Arial","Normal","Blue",12,TRUE})
theLabelThemes.Add({"Index.shp","Quad_No","Times","Bold","Red",18,TRUE})

' 2 Make list of themes to report that includes an ordered list of field names to print

' {theThemeName,{theFieldName1,theFieldName2,theFieldName3,,,}}

theReportThemes = list.Make
theReportThemes.Add({"Avtown.shp",{"Town","Town_No"}})
theReportThemes.Add({"Index.shp",{"Quad_no","Quadrangle"}})

' 3  Specify the name of report appearing on the top of the page

theReportTitle = "Report Of Features Shown On Map"

' 4  Specify scripts used to make the map, label the map, and make the report

theMapScriptName = "zView.MapAndReportMakeMap"
theLabelAddScriptName = "zView.MapAndReportLabelAdd"
theLabelDeleteScriptName = "zView.MapAndReportLabelDelete"
theReportScriptName = "zView.MapAndReportMakeReport"

' 5  Edit zView.MapAndReportMakeMap script to specify the map title and legend 
'    in the title box area.

Other scripts

Reading and printing the scripts

201 Scripts

Author Information

July, 1999