Professional IronPython

Defining Complex Forms
At some point, simple message boxes simply won’t do the job for you. After all, you’ll want forms 
that contain a number of fields that you can use to process complex information from the user. In 
this case, you must create a standard Windows form for your extension. To accomplish this task, 
you begin by adding the form using the following steps.
1.
Right-click Dialogs in Solution Explorer and choose Add
➤➤➪➤➤
New Item. Select the Windows 
Forms entry in the Installed Templates list. You see the Add New Item dialog box shown in 
Figure 16-10.
fIgURE 16-10: 
Add a Windows Form to your project.
2.
Highlight the Windows Form entry. Type 
TestForm.CS
in the Name field and click Add. 
Visual Studio adds the new form to your project and automatically opens it for editing.
548592c16.indd 342
2/24/10 12:49:25 PM
www.finebook.ir

---

Using C# for User Interface Support
 
❘
 
343
At this point, you can create the form just as you normally 
would for any static application. Figure 16-11 shows the form 
used for this example. It’s simple, but it contains multiple data-
entry fields and multiple exit options.
Before you assume anything about this form, note that it does 
differ in a few ways from the forms you’ve created for your 
static applications. The first difference is that the buttons that 
close the form, rather than do something within the form, 
must have the 
DialogResult
property set to a unique value 
or you won’t be able to tell which button the user clicked. For 
this example, the 
DialogResult
for 
btnOK
is 
OK
, while the 
DialogResult
for 
btnCancel
is 
Cancel
.
The second difference involves a problem with getting informa-
tion from the form you create to the IronPython application. 
You could contrive all sorts of odd methods for accomplish-
ing the task, but the simplest method is to set the 
Modifiers
property for the individual controls 
(
txtName
and 
txtColor
) to 
Public
. In this case, using 
Public
doesn’t create a problem because 
IronPython sets everything to public. In all other respects, there’s no difference between this form 
and any other form you’ve created in the past.
To make things simple, this example doesn’t use any code-behind for the form itself. Any code-
behind works as you’d expect. There isn’t any difference between calling the form from IronPython 
than calling it from within your C# application.