# General Notes

This document describes the "common dialogs" by which we mean those system-level dialogs that are often used in PythonCard applications. A separate document describes custom dialogs, i.e., those that you create in your own applications that are specific to those programs' needs.

Two notes are important regardless of which of the common dialogs you work with.

First, although every document describing one of these dialogs discusses a variable called "result" in which the results of user interaction with the dialog are stored. You can call this variable anything you like. The samples use the variable "result" and the documentation follows that lead, but it is not necessary that you call this variable anything special.

Second, while the dialog documentation shows you how to create each dialog programmatically, there is an alternative way of creating some of the dialogs. In the PythonCard codeEditor, you can choose the "insertDialog" option from the "Scriptlets" menu, then choose the type of dialog you wish to create. A skeletal text framework of valid Python code will be placed into the code editor at the insertion point. You can then simply edit that starter text to describe your specific needs.