Professional IronPython

370
❘
CHAPTER 17
ExtEnding ironPython Using VisUal Basic.nEt
End Function
Public Function __doc__() As String
Return “This is a help string”
End Function
End Class
Before you can compile this code, you
need to add a reference to 
System.Windows 
.Forms.DLL
. Right-click Dialogs in Solution 
Explorer and choose Add Reference from the 
context menu. You’ll see the Add Reference 
dialog box shown in Figure 17-7. Highlight 
the 
System.Windows.Forms
entry and click 
OK. At this point, you also need to add an 
Imports System.Windows.Forms
entry to 
your project and you’re ready to work with 
message boxes.
The code begins by creating a series of 
ShowMessage()
methods. The first is rela-
tively simple and the complexity increases 
with each 
ShowMessage()
method entry. 
Notice that the 
ShowMessage()
method uses 
Int16
input values to select the buttons, icon, 
and default button. You could also use enu-
merations to provide input values. The one thing you don’t want to do is ask the IronPython developer 
to provide a 
MessageBoxButtons
, 
MessageBoxIcon
, or 
MessageBoxDefaultButton
value, because 
then the IronPython developer would need to import all the required .NET Framework functionality, 
reducing the usefulness of your extension. The 
CType()
function helps you convert the 
Int16
values 
into the appropriate enumeration value. Interestingly enough, there are 21 forms of the 
MessageBox 
.Show()
method, even though the example shows only five of them.
The enumeration values used to access message box features aren’t consistent. For 
example, the 
MessageBoxIcon
 enumeration has values of 0, 16, 32, 48, and 64, 
which are hardly easy to remember. The 
MessageBoxDefaultButton
 enumeration 
values are equally odd at 0, 256, and 512. Fortunately, the 
MessageBoxButtons
enumeration is a straightforward list of 0 through 5. In Chapter 16, Tables 16-1 
through 16-3 show the values for the message box enumerations.