This document is archived and information here might be outdated.  Recommended version.


Title, long description, type, and directory options for the ArcGIS Snippet Editor (ArcObjects .NET 10.4 SDK)

Title, long description, type, and directory options for the ArcGIS Snippet Editor


Summary
Use the ArcGIS Snippet Editor dialog box to create ArcGIS snippets and to specify the snippet title, long description, type, and output directory location. This topic discusses each option on the Title, Long Description, Type, Directory - ArcGIS Snippet Editor dialog box.

In this topic


About the ArcGIS Snippet Editor title, long description, type, and directory options

The Title, Long Description, Type, Directory – ArcGIS Snippet Editor dialog box is the second in a series of dialog boxes that lets you create or edit an ArcGIS snippet. See the following screen shot:
 

Using the title, long description, type, and directory options

The following describes the areas on the Title, Long Description, Type, Directory - ArcGIS Snippet Editor dialog box:
  • Title—Type a short descriptive name for the ArcGIS snippet. The title is saved with a .snippet extension. Make sure the title only contains American Standard Code for Information Interchange (ASCII) characters. The following are acceptable:
    • A-Z
    • a-z
    • 0-9
    • - (hyphen)
    • _ (underscore)
    • Spaces

    The title name shows in the ArcGIS Snippet Finder with the standard Microsoft snippet insertion hierarchy. The title information is also used to generate the ArcGIS snippet title in the Additional Comments section.
  • Long Description—Type a more detailed explanation for the functionality of the ArcGIS snippet. This information is also used to generate the Long Description in the Additional Comments section.
For more information about the Additional Comments section, see "Insertion preferences" in the topic, Code insertion options.
  • Snippet Type—Select a snippet type from the Snippet Type drop-down list. The snippet type is a special tag in the Extensible Markup Language (XML) for the ArcGIS snippet, which indicates the type of snippet you are creating. The following are the snippet types in the drop-down list:
    • function-sub-method—A single function or sub (Visual Basic), or method (C#) code fragments placed at the root level of a class file. The function-sub-method is the default snippet type. 
    • statements—Code fragments that act as templates for you to modify. Usually, code from statements snippets will not compile unless you make modifications. Unless otherwise directed, insert statements snippets in an existing method, function, or sub in your class. Typically, they do not perform a complete programming task. The majority of snippets provided by Microsoft with Visual Studio are the statements type (that is, code fragments). Microsoft does not make a distinction between different snippet types (this is a term specific to ArcGIS snippets). For more information, see Statements option for the ArcGIS Snippet Editor.
    • other—This snippet type has multiple methods, subs or functions, or global variables that need to be at the root of a class file. The ArcGIS Snippet Editor can also be used if the snippet contains the complete contents of a class file. The "other" snippet type can be inserted anywhere in a class file, although the typical behavior is to insert the code at the root of the class file.

      Depending on the specified snippet type, determines the behavior of the ArcGIS Snippet Finder when you insert a snippet into your class file. The ArcGIS Snippet Finder shows warning messages if you try to insert an ArcGIS snippet in an invalid location in the class file; therefore, make sure you specify the correct snippet type. See the following screen shots that show the warning messages: 


  • Output Directory—Click the Specify an Output Directory folder browser button to specify the ArcGIS snippet's output directory location (opens the Browse For Folder dialog box). You "cannot" type in the Output Directory text box. You must click the Specify an Output Directory folder browser button to change the location where the ArcGIS Snippet Editor writes snippets to disk.
Changing the output directory on the Title, Long Description, Type, Directory – ArcGIS Snippet Editor dialog box changes the default directory location in the ArcGIS Snippet Editor Manager dialog box.
The initial default location for user created ArcGIS snippets is %APPDATA%\ESRI\ArcGISSnippets. The %APPDATA% environment variable is set by the Windows operating system. To verify the %APPDATA% location, type %APPDATA% in Windows Explorer's Address bar, then press Enter.
The directory path the ArcGIS Snippet Editor uses to list custom ArcGIS snippets is persisted in the following location:
  • %APPDATA%\ESRI\ArcGISSnippets\Settings\ArcGISSnippetEditorPreferences9.xml
For Windows Vista developers—If you cannot navigate to the %APPDATA% folder when using the Browse For Folder dialog box from the ArcGIS Snippet Editor dialog box, you may need to change the Windows Operating System folder options to show hidden files and folders. By default in Windows Vista, the folder options is to not show hidden files and folders.
The following is a screen shot of not being able to see the %APPDATA% folder in Windows Vista when the folder options is set to do not show hidden files and folders:
The following is a screen shot of being able to see the %APPDATA% folder in Windows Vista when the folder options is set to show hidden files and folders.
To change the options in Windows Vista to view hidden files and folders, open the Control Panel and switch to the Classic View. Click the Folder Options icon and select the View tab, then choose Show hidden files and folders to enable viewing of the %APPDATA% directory. See the following screen shot:


See Also:

ArcGIS Snippet Editor
Overview of the ArcGIS Snippet Editor Manager
Customization options for the ArcGIS Snippet Editor Manager
Source code option for the ArcGIS Snippet Editor
References option for the ArcGIS Snippet Editor
Extensions, products, and versions options for the ArcGIS Snippet Editor
Snippets for ArcGIS .NET developers
ArcGIS Snippet Finder




Additional Requirements
  • Use display settings of 96 dots per inch (dpi) when using the ArcGIS Snippet Finder and ArcGIS Snippet Editor.

Development licensing Deployment licensing
ArcGIS for Desktop Basic ArcGIS for Desktop Basic
ArcGIS for Desktop Standard ArcGIS for Desktop Standard
ArcGIS for Desktop Advanced ArcGIS for Desktop Advanced
Engine Developer Kit Engine