2002 prentice hall. all rights reserved. 1 week 7: gui questions from last lecture –exception...

2002 Prentice Hall. All rights reserved.

1

Week 7: GUI

• Questions from last lecture– Exception handling

– Try-Catch blocks

– Catching outside of scope

• Homework and Practical at end of slides


2

Outline12.1 Introduction12.2 Windows Forms12.3 Event-Handling Model

12.3.1 Basic Event Handling12.4 Control Properties and Layout12.5 Labels, TextBoxes and Buttons12.6 GroupBoxes and Panels12.7 CheckBoxes and RadioButtons12.8 PictureBoxes12.9 Mouse Event Handling12.10 Keyboard Event Handling

Chapter 12 - Graphical User Interface Concepts: Part 1


3

12.1 Introduction

• Graphical user interface– Allow interaction with program visually

– Give program distinct look and feel

– Built from window gadgets

– Is an object, accessed via keyboard or mouse


4

12.1 Introduction

Fig. 12.1 Sample Internet Explorer window with GUI components.

Button Label Menu Bar TextBox Scrollbar


5

12.1 Introduction

Control Description Label An area in which icons or uneditable text can be displayed.

TextBox An area in which the user inputs data from the keyboard. The area also can display information.

Button An area that triggers an event when clicked.

CheckBox A GUI control that is either selected or not selected.

ComboBox A drop-down list of items from which the user can make a selection, by clicking an item in the list or by typing into the box, if permitted.

ListBox An area in which a list of items is displayed from which the user can make a selection by clicking once on any element. Multiple elements can be selected.

Panel A container in which components can be placed.

ScrollBar Allows the user to access a range of values that cannot normally fit in its container.

Fig. 12.2 Some basic GUI components.


6

12.2 Windows Forms

• WinForms– Create GUIs for programs

– Element on the desktop

– Represented by:• Dialog

• Window

• MDI window


7

12.2 Windows Forms

• Component– Class that implements IComponent interface

– Lacks visual parts

• Control– Component with graphical part

• Such as button or label

– Are visible

• Event– Generated by movement from mouse or keyboard

– Event handlers performs action• Specifics written by programmer


8

12.2 Windows Forms

Fig. 12.3 Components and controls for Windows Forms.


9

12.2 Windows FormsForm Properties and Events

Description / Delegate and Event Arguments

Common Properties

AcceptButton Which button will be clicked when Enter is pressed.

AutoScroll Whether scrollbars appear when needed (if data fills more than one screen).

CancelButton Button that is clicked when the Escape key is pressed.

FormBorderStyle Border of the form (e.g., none, single, 3D, sizable).

Font Font of text displayed on the form, as well as the default font of controls added to the form.

Text Text in the form’s title bar.

Common Methods

Close Closes form and releases all resources. A closed form cannot be reopened.

Hide Hides form (does not release resources).

Show Displays a hidden form.

Common Events (Delegate EventHandler, event arguments EventArgs)

Load Occurs before a form is shown. This event is the default when the form is double-clicked in the Visual Studio .NET designer.

Fig. 12.4 Common Form properties and events.


10

12.3 Event-Handling Model

• GUIs are event driven• Event handlers

– Methods that process events and perform tasks.

• Associated delegate– Objects that reference methods

– Contain lists of method references• Must have same signature

– Intermediaries for objects and methods

– Signature for control’s event handler


11

12.3 Event-Handling Model

Fig. 12.5 Event-handling model using delegates.

Object A raises event E Delegate for event E

Handler 1 for event E



calls

calls


12

12.3.1 Basic Event Handling

• Event handler– Must have same signature as corresponding delegate

– Two object reference are passed in

– ControlName_EventName

– Must be registered with delegate object• Add event handlers to the delegate’s invocation list

– New delegate object for each event handler

• Event multicasting– Have multiple handlers for one event

– Order called for event handlers is indeterminate


13


Fig. 12.6 Events section of the Properties window.

Current even handler (none)

Selected event

Event description

List of events supported by control

Events icon

2002 Prentice Hall.All rights reserved.

Outline14

SimpleEventExample.cs

1 // Fig. 12.7: SimpleEventExample.cs2 // Using Visual Studio .NET to create event handlers.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 // program that shows a simple event handler12 public class MyForm : System.Windows.Forms.Form13 {14 private System.ComponentModel.Container components = null;15 16 // Visual Studio .NET generated code17 18 [STAThread]19 static void Main() 20 {21 Application.Run( new MyForm() );22 }23 24 // Visual Studio .NET creates an empty handler, 25 // we write definition: show message box when form clicked26 private void MyForm_Click( object sender, System.EventArgs e )27 {28 MessageBox.Show( "Form was pressed" );29 }30 31 } // end class MyForm

Create an event handler

Signature of the event handlerReference to the object that raised the event (sender)

Reference to an event arguments object (e)

Class EventArgs is base class for objects with event information


Outline15

SimpleEventExample.csProgram Output


16


Fig. 12.8 List of Form events.

Class name List of events


17


Fig. 12.9 Details of Click event.

Event delegate Event argument class

Event name


18

12.4 Control Properties and Layout

• Common properties– Derive from class Control

– Text property• Specifies the text that appears on a control

– Focus method• Transfers the focus to a control

• Becomes active control

– TabIndex property• Order in which controls are given focus

• Automatically set by Visual Studio .NET

– Enable property• Indicate a control’s accessibility


19


• Visibility control– Hide control from user

• Or use method Hide

• Anchor property– Anchoring control to specific location

• Constant distance from specified location

– Unanchored control moves relative to the position

– Docking allows control to spread itself along and entire side

– Both options refer to the parent container

• Size structure– Allow for specifying size range

• MinimumSize and MaximumSize property


20

12.4 Control Properties and LayoutClass Control Properties and Methods

Description

Common Properties

BackColor Background color of the control.

BackgroundImage Background image of the control.

Enabled Whether the control is enabled (i.e., if the user can interact with it). A disabled control will still be displayed, but “grayed-out”—portions of the control will become gray.

Focused Whether a control has focus. (The control that is currently being used in some way.)

Font Font used to display control’s Text.

ForeColor Foreground color of the control. This is usually the color used to display the control’s Text property.

TabIndex Tab order of the control. When the Tab key is pressed, the focus is moved to controls in increasing tab order. This order can be set by the programmer.

TabStop If true, user can use the Tab key to select the control.

Text Text associated with the control. The location and appearance varies with the type of control.

TextAlign The alignment of the text on the control. One of three horizontal positions (left, center or right) and one of three vertical positions (top, middle or bottom).

Visible Whether the control is visible.

Common Methods

Focus Transfers the focus to the control.

Hide Hides the control (sets Visible to false).

Show Shows the control (sets Visible to true).

Fig. 12.10 Class Control properties and methods.


21


Fig. 12.11 Anchoring demonstration.

Constant distance to left and top sides

Before resize After resize


22


Fig. 12.12 Manipulating the Anchor property of a control.

Darkened bar indicates to which wall control is anchored

Click down-arrow in Anchor property to display anchoring window


23


Fig. 12.13 Docking demonstration.

Control expands along top portion of the form


24


Common Layout Properties

Description

Common Properties

Anchor Side of parent container at which to anchor control—values can be combined, such as Top, Left.

Dock Side of parent container to dock control—values cannot be combined.

DockPadding (for containers)

Sets the dock spacing for controls inside the container. Default is zero, so controls appear flush against the side of the container.

Location Location of the upper-left corner of the control, relative to it’s container.

Size Size of the control. Takes a Size structure, which has properties Height and Width.

MinimumSize, MaximumSize (for Windows Forms)

The minimum and maximum size of the form.

Fig. 12.14 Class Control layout properties.


25

12.5 Labels, TextBoxes and Buttons

• Labels– Provide text instruction

• Read only text

– Defined with class Label1• Derived from class Control

• Textbox– Class TextBox

– Area for text input• Password textbox


26

12.5 Labels, TextBoxes and Buttons

• Button– Control to trigger a specific action

• Checkboxes or radio buttons

– Derived from ButtonBase


27

12.5 Labels TextBoxes and Buttons

Label Properties


Common Properties

Font The font used by the text on the Label.

Text The text to appear on the Label.

TextAlign The alignment of the Label’s text on the control. One of three horizontal positions (left, center or right) and one of three vertical positions (top, middle or bottom).

Fig. 12.15 Label properties.


28


TextBox Properties and Events


Common Properties

AcceptsReturn If true, pressing Enter creates a new line if textbox spans multiple lines. If false, pressing Enter clicks the default button of the form.

Multiline If true, textbox can span multiple lines. Default is false.

PasswordChar Single character to display instead of typed text, making the TextBox a password box. If no character is specified, Textbox displays the typed text.

ReadOnly If true, TextBox has a gray background and its text cannot be edited. Default is false.

ScrollBars For multiline textboxes, indicates which scrollbars appear (none, horizontal, vertical or both).

Text The text to be displayed in the text box.


TextChanged Raised when text changes in TextBox (the user added or deleted characters). Default event when this control is double clicked in the designer.

Fig. 12.16 TextBox properties and events.


29


Button properties and events


Common Properties

Text Text displayed on the Button face.


Click Raised when user clicks the control. Default event when this control is double clicked in the designer.

Fig. 12.17 Button properties and events.


Outline30

LabelTextBoxButtonTest.cs

1 // Fig. 12.18: LabelTextBoxButtonTest.cs2 // Using a Textbox, Label and Button to display3 // the hidden text in a password box.4 5 using System;6 using System.Drawing;7 using System.Collections;8 using System.ComponentModel;9 using System.Windows.Forms;10 using System.Data;11 12 // namespace contains our form to display hidden text13 namespace LabelTextBoxButtonTest14 {15 /// <summary>16 /// form that creates a password textbox and17 /// a label to display textbox contents18 /// </summary>19 public class LabelTextBoxButtonTest : 20 System.Windows.Forms.Form21 {22 private System.Windows.Forms.Button displayPasswordButton;23 private System.Windows.Forms.Label displayPasswordLabel;24 private System.Windows.Forms.TextBox inputPasswordTextBox;25 26 /// <summary>27 /// Required designer variable.28 /// </summary>29 private System.ComponentModel.Container components = null;30 31 // default contructor32 public LabelTextBoxButtonTest()33 {34 InitializeComponent();35 }

Visual Studio .NET adds comments to our code

Visual Studio .NET inserts declarations for the control we added to the form The IDE manages these declaration

Declare reference components (an array)Reference is null

Constructor for the form is created for usMethod InitializeComponent creates components and controls in the form and sets their properties


Outline31


36 37 /// <summary>38 /// Clean up any resources being used.39 /// </summary>40 protected override void Dispose( bool disposing )41 {42 if ( disposing )43 {44 if ( components != null ) 45 {46 components.Dispose();47 }48 }49 50 base.Dispose( disposing );51 }52 53 #region Windows Form Designer generated code54 /// <summary>55 /// Required method for Designer support - do not modify56 /// the contents of this method with the code editor.57 /// </summary>58 private void InitializeComponent()59 {60 this.displayPasswordButton = 61 new System.Windows.Forms.Button();62 this.inputPasswordTextBox = 63 new System.Windows.Forms.TextBox();64 this.displayPasswordLabel = 65 new System.Windows.Forms.Label();66 this.SuspendLayout();67

Method Dispose cleans up allocated resources

#region preprocessor directives allow collapsible code in Visual Studio .NET

Create new objects for the control we added


Outline32


68 // 69 // displayPasswordButton70 // 71 this.displayPasswordButton.Location = 72 new System.Drawing.Point( 96, 96 );73 this.displayPasswordButton.Name = 74 "displayPasswordButton";75 this.displayPasswordButton.TabIndex = 1;76 this.displayPasswordButton.Text = "Show Me";77 this.displayPasswordButton.Click += 78 new System.EventHandler( 79 this.displayPasswordButton_Click );80 81 // 82 // inputPasswordTextBox83 // 84 this.inputPasswordTextBox.Location = 85 new System.Drawing.Point( 16, 16 );86 this.inputPasswordTextBox.Name = 87 "inputPasswordTextBox";88 this.inputPasswordTextBox.PasswordChar = '*';89 this.inputPasswordTextBox.Size = 90 new System.Drawing.Size( 264, 20 );91 this.inputPasswordTextBox.TabIndex = 0;92 this.inputPasswordTextBox.Text = "";93 94 // 95 // displayPasswordLabel96 // 97 this.displayPasswordLabel.BorderStyle = 98 System.Windows.Forms.BorderStyle.Fixed3D;99 this.displayPasswordLabel.Location = 100 new System.Drawing.Point( 16, 48 );101 this.displayPasswordLabel.Name = 102 "displayPasswordLabel";

Set the Name, PasswordChar and Text properties for inputPasswordTextBox

Visual Studio .NET register the event handler for us


Outline33


103 this.displayPasswordLabel.Size = 104 new System.Drawing.Size( 264, 23 );105 this.displayPasswordLabel.TabIndex = 2;106 107 // 108 // LabelTextBoxButtonTest109 // 110 this.AutoScaleBaseSize = 111 new System.Drawing.Size( 5, 13 );112 this.ClientSize = 113 new System.Drawing.Size( 292, 133 );114 this.Controls.AddRange(115 new System.Windows.Forms.Control[] {116 this.displayPasswordLabel,117 this.inputPasswordTextBox,118 this.displayPasswordButton});119 this.Name = "LabelTextBoxButtonTest";120 this.Text = "LabelTextBoxButtonTest";121 this.ResumeLayout( false );122 123 } // end method InitializeComponent124 125 // end collapsible region started on line 53126 #endregion127 128 /// <summary>129 /// The main entry point for the application.130 /// </summary>131 [STAThread]132 static void Main() 133 {134 Application.Run( new LabelTextBoxButtonTest() );135 }136

#endregion signal the end of the collapsible region


Outline34


Program Output

137 // display user input on label138 protected void displayPasswordButton_Click( 139 object sender, System.EventArgs e )140 {141 // text has not changed142 displayPasswordLabel.Text = 143 inputPasswordTextBox.Text;144 }145 146 } // end class LabelTextBoxButtonTest147 148 } // end namespace LabelTextBoxButtonTest

Create an empty event handler named displayPasswordButton_Click

To show the text, set displayPasswordLabel’s Text to inputPasswordTextBox’s Text

User must program this line manually


35

12.6 GroupBoxes and Panels

• Arrange components on a GUI– GroupBoxes can display a caption

• Text property determines its caption

– Panels can have scrollbar• View additional controls inside the Panel


36


GroupBox Properties Description

Common Properties

Controls The controls that the GroupBox contains.

Text Text displayed on the top portion of the GroupBox (its caption).

Fig. 12.19 GroupBox properties.


37


Panel Properties Description

Common Properties

AutoScroll Whether scrollbars appear when the Panel is too small to hold its controls. Default is false.

BorderStyle Border of the Panel (default None; other options are Fixed3D and FixedSingle).

Controls The controls that the Panel contains.

Fig. 12.20 Panel properties.


38


Fig. 12.21 Creating a Panel with scrollbars.

Controls inside panel panel

panel scrollbars


Outline39

GroupBoxPanelExample.cs

1 // Fig. 12.22: GroupBoxPanelExample.cs 2 // Using GroupBoxes and Panels to hold buttons.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 /// form to display a groupbox versus a panel12 public class GroupBoxPanelExample : System.Windows.Forms.Form13 {14 private System.Windows.Forms.Button hiButton;15 private System.Windows.Forms.Button byeButton;16 private System.Windows.Forms.Button leftButton;17 private System.Windows.Forms.Button rightButton;18 19 private System.Windows.Forms.GroupBox mainGroupBox;20 private System.Windows.Forms.Label messageLabel;21 private System.Windows.Forms.Panel mainPanel;22 23 private System.ComponentModel.Container components = null;24 25 // Visual Studio .NET-generated Dispose method26 27 [STAThread]28 static void Main() 29 {30 Application.Run( new GroupBoxPanelExample() );31 }32

messageLabel is initially blank

GroupBox (name mainGroupBox)

Panel (name mainPanel)

Control AutoScroll property set to TRUE


Outline40

GroupBoxPanelExample.cs

33 // event handlers to change messageLabel34 35 // event handler for hi button36 private void hiButton_Click( 37 object sender, System.EventArgs e )38 {39 messageLabel.Text= "Hi pressed";40 }41 42 // event handler for bye button43 private void byeButton_Click( 44 object sender, System.EventArgs e )45 {46 messageLabel.Text = "Bye pressed";47 }48 49 // event handler for far left button50 private void leftButton_Click( 51 object sender, System.EventArgs e )52 {53 messageLabel.Text = "Far left pressed";54 }55 56 // event handler for far right button57 private void rightButton_Click( 58 object sender, System.EventArgs e )59 {60 messageLabel.Text = "Far right pressed";61 }62 63 } // end class GroupBoxPanelExample

Represent event handlers

hiButton and byeButton belong to GroupBox

Panel has two buttons, leftButton and rightButton

Line messageLabel added to customize the text


Outline41

GroupBoxPanelExample.csProgram Output

hiButton_Click

leftButton_Click rightButton_Click


42

12.7 Checkboxes and RadioButtons

• State buttons– On/off or true/false state

– Derived from class ButtonBase• CheckBox

– No restriction on usage

• RadioButton

– Grouped together

– Only one can be true

– Mutually exclusive options


43

12.7 CheckBoxes and RadioButtons

CheckBox events and properties


Common Properties

Checked Whether or not the CheckBox has been checked.

CheckState Whether the Checkbox is checked (contains a black checkmark) or unchecked (blank). An enumeration with values Checked, Unchecked or Indeterminate.

Text Text displayed to the right of the CheckBox (called the label).


CheckedChanged Raised every time the Checkbox is either checked or unchecked. Default event when this control is double clicked in the designer.

CheckStateChanged Raised when the CheckState property changes.

Fig. 12.23 CheckBox properties and events.


Outline44

CheckBoxTest.cs

1 // Fig. 12.24: CheckBoxTest.cs2 // Using CheckBoxes to toggle italic and bold styles.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 /// form contains checkboxes to allow12 /// the user to modify sample text13 public class CheckBoxTest : System.Windows.Forms.Form14 {15 private System.Windows.Forms.CheckBox boldCheckBox;16 private System.Windows.Forms.CheckBox italicCheckBox;17 18 private System.Windows.Forms.Label outputLabel;19 20 private System.ComponentModel.Container components = null;21 22 // Visual Studio .NET-generated Dispose method23 24 /// The main entry point for the application.25 [STAThread]26 static void Main() 27 {28 Application.Run( new CheckBoxTest() );29 }30

When program start, both Checkbox is unchecked

Text property set to Bold

Text property set to ItalicThe Label OutputLabel is labeled Watch the font style change


Outline45

CheckBoxTest.cs

31 // make text bold if not bold, 32 // if already bold make not bold33 private void boldCheckBox_CheckedChanged( 34 object sender, System.EventArgs e )35 {36 outputLabel.Font = 37 new Font( outputLabel.Font.Name,38 outputLabel.Font.Size,39 outputLabel.Font.Style ^ FontStyle.Bold );40 }41 42 // make text italic if not italic, 43 // if already italic make not italic44 private void italicCheckBox_CheckedChanged( 45 object sender, System.EventArgs e )46 {47 outputLabel.Font = 48 new Font( outputLabel.Font.Name,49 outputLabel.Font.Size,50 outputLabel.Font.Style ^ FontStyle.Italic );51 }52 53 } // end class CheckBoxTest

Font constructor takes in the font name, size, and style

Style is a member of the FontStyle enumerationStyle property

itself is read-onlyFont object’s Style property is set when object is created

Style can use bitwise operators


Outline46

CheckBoxTest.csProgram Output

Result when bold is selected

Result when both styles are selected


47

12.7 CheckBoxes and RadioButtons

RadioButton properties and events


Common Properties

Checked Whether the RadioButton is checked.

Text Text displayed to the right of the RadioButton (called the label).


Click Raised when user clicks the control.

CheckedChanged Raised every time the RadioButton is checked or unchecked. Default event when this control is double clicked in the designer.

Fig. 12.25 RadioButton properties and events.


Outline48

RadioButtonsTest.cs

1 // Fig. 12.26: RadioButtonsTest.cs2 // Using RadioButtons to set message window options.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 /// form contains several radio buttons--user chooses one12 /// from each group to create a custom MessageBox13 public class RadioButtonsTest : System.Windows.Forms.Form14 {15 private System.Windows.Forms.Label promptLabel;16 private System.Windows.Forms.Label displayLabel;17 private System.Windows.Forms.Button displayButton;18 19 private System.Windows.Forms.RadioButton questionButton;20 private System.Windows.Forms.RadioButton informationButton;21 private System.Windows.Forms.RadioButton exclamationButton;22 private System.Windows.Forms.RadioButton errorButton;23 private System.Windows.Forms.RadioButton retryCancelButton;24 private System.Windows.Forms.RadioButton yesNoButton;25 private System.Windows.Forms.RadioButton yesNoCancelButton;26 private System.Windows.Forms.RadioButton okCancelButton;27 private System.Windows.Forms.RadioButton okButton;28 private System.Windows.Forms.RadioButton29 abortRetryIgnoreButton;30 31 private System.Windows.Forms.GroupBox groupBox2;32 private System.Windows.Forms.GroupBox groupBox1;33 34 private MessageBoxIcon iconType = MessageBoxIcon.Error;

To store user’s choice of options iconType is created. Object iconType is a

MessageBoxIcon enumeration

The enumeration name indicate which button to display

Label is used to prompt userLabel is used to display which button was pressedDisplay the text Display

RadioButtons are created for the enumeration options

One event handling exists for all the radio buttons in groupBox1 and groupBox2


Outline49

RadioButtonsTest.cs

35 private MessageBoxButtons buttonType = 36 MessageBoxButtons.OK;37 38 /// The main entry point for the application.39 [STAThread]40 static void Main() 41 {42 Application.Run( new RadioButtonsTest() );43 }44 45 // change button based on option chosen by sender46 private void buttonType_CheckedChanged(47 object sender, System.EventArgs e )48 {49 if ( sender == okButton ) // display OK button50 buttonType = MessageBoxButtons.OK;51 52 // display OK and Cancel buttons53 else if ( sender == okCancelButton )54 buttonType = MessageBoxButtons.OKCancel;55 56 // display Abort, Retry and Ignore buttons57 else if ( sender == abortRetryIgnoreButton )58 buttonType = MessageBoxButtons.AbortRetryIgnore;59 60 // display Yes, No and Cancel buttons61 else if ( sender == yesNoCancelButton )62 buttonType = MessageBoxButtons.YesNoCancel;63 64 // display Yes and No buttons65 else if ( sender == yesNoButton )66 buttonType = MessageBoxButtons.YesNo;67 68 // only one option left--display 69 // Retry and Cancel buttons

To store user’s choice of options buttonType is createdObject buttonType is a MessageBoxButtom enumeration

The enumeration name indicate which button to display

Each radio button generates a CheckedChanged when clicked

Handlers compare the sender object with every radio button to determine which button was selected


Outline50

RadioButtonsTest.cs

70 else71 buttonType = MessageBoxButtons.RetryCancel;72 73 } // end method buttonType_CheckedChanged74 75 // change icon based on option chosen by sender76 private void iconType_CheckedChanged(77 object sender, System.EventArgs e )78 {79 if ( sender == errorButton ) // display error icon80 iconType = MessageBoxIcon.Error;81 82 // display exclamation point83 else if ( sender == exclamationButton )84 iconType = MessageBoxIcon.Exclamation;85 86 // display information icon87 else if ( sender == informationButton ) 88 iconType = MessageBoxIcon.Information;89 90 else // only one option left--display question mark91 iconType = MessageBoxIcon.Question;92 93 } // end method iconType_CheckedChanged94 95 // display MessageBox and button user pressed96 protected void displayButton_Click( 97 object sender, System.EventArgs e )98 {99 DialogResult result = 100 MessageBox.Show( "This is Your Custom MessageBox.", 101 "Custom MessageBox", buttonType, iconType, 0, 0 );102 103 // check for dialog result and display it in label104 switch ( result )

Handlers compare the sender object with every radio button to determine which button was selected

Click handler for displayButton creates a MessageBox

Result of message box is a DialogResult enumeration

Switch statement tests for the result and set displayLabel.Text appropriately


Outline51

RadioButtonsTest.cs

105 {106 case DialogResult.OK: 107 displayLabel.Text = "OK was pressed."; 108 break;109 110 case DialogResult.Cancel: 111 displayLabel.Text = "Cancel was pressed."; 112 break;113 114 case DialogResult.Abort: 115 displayLabel.Text = "Abort was pressed."; 116 break;117 118 case DialogResult.Retry: 119 displayLabel.Text = "Retry was pressed."; 120 break;121 122 case DialogResult.Ignore: 123 displayLabel.Text = "Ignore was pressed."; 124 break;125 126 case DialogResult.Yes: 127 displayLabel.Text = "Yes was pressed."; 128 break;129 130 case DialogResult.No: 131 displayLabel.Text = "No was pressed."; 132 break;133 134 } // end switch135 136 } // end method displayButton_Click137 138 } // end class RadioButtonsTest

The result input will help determine which text to display among the cases


Outline52

RadioButtonsTest.cs Program Output

Exclamation icon type Error icon type

OKCancel button type OK button type

Radio button style allow user to select one per column


Outline53

RadioButtonsTest.cs Program Output

AbortRetryIgnore button type

RetryCancel button type

Information icon type Question icon type

YesNoCancel button type

YesNo button type


54

12.8 PictureBoxes

• Class PictureBox– Displays an image

• Image set by object of class Image.

– The Image property sets the Image object to use

– SizeMode property sets how the image is displayed


55

12.8 PictureBoxes

PictureBox properties and events


Common Properties

Image Image to display in the PictureBox.

SizeMode Enumeration that controls image sizing and positioning. Values Normal (default), StretchImage, AutoSize and CenterImage. Normal puts image in top-left corner of PictureBox and CenterImage puts image in middle (both cut off image if too large). StretchImage resizes image to fit in PictureBox. AutoSize resizes PictureBox to hold image.


Click Raised when user clicks the control. Default event when this control is double clicked in the designer.

Fig. 12.27 PictureBox properties and events.


Outline56

PictureBoxTest.cs

1 // Fig. 12.28: PictureBoxTest.cs2 // Using a PictureBox to display images.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 using System.IO;11 12 /// form to display different images when clicked13 public class PictureBoxTest : System.Windows.Forms.Form14 {15 private System.Windows.Forms.PictureBox imagePictureBox;16 private System.Windows.Forms.Label promptLabel;17 18 private int imageNum = -1;19 20 /// The main entry point for the application.21 [STAThread]22 static void Main() 23 {24 Application.Run( new PictureBoxTest() );25 }26 27 // change image whenever PictureBox clicked28 private void imagePictureBox_Click( 29 object sender, System.EventArgs e )30 {31 imageNum = ( imageNum + 1 ) % 3; // imageNum from 0 to 232

PictureBox imagePicture use to display one of three bitmap images

Includes instructions Click On Picture Box to View Images

To respond to the Click event

Store the image we want to display

Modulus calculation insures that number is between 0 and 2


Outline57

PictureBoxTest.cs

Program Output

33 // create Image object from file, display on PictureBox34 imagePictureBox.Image = Image.FromFile( 35 Directory.GetCurrentDirectory() + "\\images\\image" + 36 imageNum + ".bmp" );37 }38 39 } // end class PictureBoxTestSet the Image property of

imagePictureBox to an ImageMethod FromFile which takes a string and creates an Image object

Method GetCurrentDirectory of Class Directory returns current directory of file as a stringUse imageNum to append

the correct number


58

12.9 Mouse Event Handling

• Class MouseEventArgs– Contain coordinates of the mouse pointer

– The mouse pressed

– Number of clicks

– Number of notches the wheel turned

– Passing mouse event

– Mouse event-handling methods take an object and MouseEventArgs object as argument

– The Click event uses delegate EventHandler and event arguments EventArgs


59

12.9 Mouse Event Handling

Mouse Events, Delegates and Event Arguments

Mouse Events (Delegate EventHandler, event arguments EventArgs)

MouseEnter Raised if the mouse cursor enters the area of the control.

MouseLeave Raised if the mouse cursor leaves the area of the control.

Mouse Events (Delegate MouseEventHandler, event arguments MouseEventArgs)

MouseDown Raised if the mouse button is pressed while its cursor is over the area of the control.

MouseHover Raised if the mouse cursor hovers over the area of the control.

MouseMove Raised if the mouse cursor is moved while in the area of the control.

MouseUp Raised if the mouse button is released when the cursor is over the area of the control.

Class MouseEventArgs Properties

Button Mouse button that was pressed (left, right, middle or none).

Clicks The number of times the mouse button was clicked.

X The x-coordinate of the event, relative to the component.

Y The y-coordinate of the event, relative to the component.

Fig. 12.29 Mouse events, delegates and event arguments.


Outline60

Painter.cs

1 // Fig 12.30: Painter.cs2 // Using the mouse to draw on a form.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 /// creates a form as a drawing surface12 public class Painter : System.Windows.Forms.Form13 {14 bool shouldPaint = false; // whether to paint15 16 /// The main entry point for the application.17 [STAThread]18 static void Main() 19 {20 Application.Run( new Painter() );21 }22 23 // should paint after mouse button has been pressed24 private void Painter_MouseDown( 25 object sender, System.Windows.Forms.MouseEventArgs e )26 {27 shouldPaint = true;28 }29 30 // stop painting when mouse button released31 private void Painter_MouseUp( 32 object sender, System.Windows.Forms.MouseEventArgs e )33 {34 shouldPaint = false;35 }

Creates variable shouldPaint to determine whether to draw on the form

The event handler for event MouseDown

shouldPaint is set to true when this event occurs

Mouse cursor will draw

The event handler of event MouseUpshouldPaint set to false, mouse

cursor will not draw


Outline61

Painter.cs

Program Output

36 37 // draw circle whenever mouse button 38 // moves (and mouse is down)39 protected void Painter_MouseMove( 40 object sender, System.Windows.Forms.MouseEventArgs e )41 {42 if ( shouldPaint )43 {44 Graphics graphics = CreateGraphics();45 graphics.FillEllipse( 46 new SolidBrush( Color.BlueViolet ), 47 e.X, e.Y, 4, 4 );48 }49 50 } // end Painter_MouseMove51 52 } // end class Painter

Program will draw only if shouldPaint is true

Creates the graphic object for the form

Provides method for drawing various shapes

Method FillEllipse draws a circle at every point the mouse cursor moves over and shouldPaint is true

SolidBrush object determines the color of the shape drawn

Create new SolidBrush object by passing the constructor a Color value

Structure Color contain numerous predefined color constants

Coordinates of x and y and the pixels height and width are supplied to the parameter list


62

12.10 Keyboard Event Handling

• Key events– Control that inherits from System.Windows.Forms.Control

– Delegate KeyPressEventHandler• Event argument KeyPressEventArgs

• KeyPress

– ASCII character pressed

– No modifier keys

– Delegate KeyEventHandler• Event argument KeyEventArgs

• KeyUp or KeyDown

– Special modifier keys

• Key enumeration value


63

12.10 Keyboard Event HandlingKeyboard Events, Delegates and Event Arguments

Key Events (Delegate KeyEventHandler, event arguments KeyEventArgs)

KeyDown Raised when key is initially pushed down.

KeyUp Raised when key is released.

Key Events (Delegate KeyPressEventHandler, event arguments KeyPressEventArgs)

KeyPress Raised when key is pressed. Occurs repeatedly while key is held down, at a rate specified by the operating system.

Class KeyPressEventArgs Properties

KeyChar Returns the ASCII character for the key pressed.

Handled Whether or not the KeyPress event was handled.

Class KeyEventArgs Properties

Alt Indicates whether the Alt key was pressed.

Control Indicates whether the Control key was pressed.

Shift Indicates whether the Shift key was pressed.

Handled Whether the event was handled.

KeyCode Returns the key code for the key, as a Keys enumeration. This does not include modifier key information. Used to test for a specific key.

KeyData Returns the key code as a Keys enumeration, combined with modifier information. Used to determine all information about the key pressed.

KeyValue Returns the key code as an int, rather than as a Keys enumeration. Used to obtain a numeric representation of the key pressed.

Modifiers Returns a Keys enumeration for any modifier keys pressed (Alt, Control and Shift). Used to determine modifier key information only.

Fig. 12.31 Keyboard events, delegates and event arguments.


Outline64

KeyDemo.cs

1 // Fig. 12.32: KeyDemo.cs2 // Displaying information about the key the user pressed.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 // form to display key press 12 // information--contains two labels13 public class KeyDemo : System.Windows.Forms.Form14 {15 private System.Windows.Forms.Label charLabel;16 private System.Windows.Forms.Label keyInfoLabel;17 18 private System.ComponentModel.Container components = null;19 20 /// The main entry point for the application.21 [STAThread]22 static void Main() 23 {24 Application.Run( new KeyDemo() );25 }26 27 // display the character pressed using key char28 protected void KeyDemo_KeyPress( 29 object sender, System.Windows.Forms.KeyPressEventArgs e )30 { 31 charLabel.Text = "Key pressed: " + e.KeyChar;32 }33

Forms contain two LabelsLabel for key pressed

Label for modifier information

Initially empty

KeyPress event handlerAccesses the KeyChar property of the KeyPressEventArgs object

Key pressed as a char

Display the key pressed

If key pressed is not ASCII, charLabel remains empty


Outline65

KeyDemo.cs

34 // display modifier keys, key code, key data and key value35 private void KeyDemo_KeyDown( 36 object sender, System.Windows.Forms.KeyEventArgs e )37 {38 keyInfoLabel.Text = 39 "Alt: " + ( e.Alt ? "Yes" : "No") + '\n' +40 "Shift: " + ( e.Shift ? "Yes" : "No" ) + '\n' +41 "Ctrl: " + ( e.Control ? "Yes" : "No" ) + '\n' + 42 "KeyCode: " + e.KeyCode + '\n' +43 "KeyData: " + e.KeyData + '\n' +44 "KeyValue: " + e.KeyValue;45 }46 47 // clear labels when key released48 private void KeyDemo_KeyUp( 49 object sender, System.Windows.Forms.KeyEventArgs e )50 {51 keyInfoLabel.Text = "";52 charLabel.Text = "";53 }

KeyEventArgs object

This block test for special keys, return bool if matched

Uses Alt, Shift, and Control properties

Displays the KeyCode, KeyData, and KeyValue properties

KeyCode returns a Keys enumeration converted into a string using ToStringKeyCode returns the key pressed without modifier keys informationKeyData property returns a Keys enumeration with data about modifier keys

KeyValue returns the key code as an integerInteger value is the Windows virtual key codeKeyUp event handler clears both labels


Outline66

KeyDemo.cs Program Output

KeyPress event was not engagedKeyDown event still raised so keyInfoLabel displays information

Keys enumeration can test for specific keys by comparing key pressed to KeyCode


67

Chapter 13 – Graphical User Interfaces Part 2

Outline13.1 Introduction13.2 Menus13.3 LinkLabels13.4 ListBoxes and CheckedListBoxes

13.4.1 ListBoxes 13.4.2 CheckedListBoxes

13.5 ComboBoxes13.6 TreeViews13.7 ListViews13.8 Tab Control13.9 Multiple Document Interface (MDI) Windows13.10 Visual Inheritance13.11 User-Defined Controls


68

13.1 Introduction

• Continues study of Graphical User Interface• Explores:

– Menus– LinkLabels– ListBox– CheckedListBox– ComboBoxes– TreeView control

– Tab controls

– Multiple-document interface windows


69

13.2 Menus

• Group related commands together• Contain:

– Commands

– Submenus

• Exit uses Application class to quit

• Color options mutually exclusive• Every option has its own event handler• Font style options use Xor operator


70

13.2 Menus

Fig. 13.1 Expanded and checked menus.

Shortcut key

Disabled command

Separator bar

Menu

submenu

Checked menu item


71

13.2 Menus

Fig. 13.2 Visual Studio .NET Menu Designer.

Text boxes used to add items to menu

MainMenu icon

Menu Designer

Place & character before the letter to be underlined


72

13.2 Menus

MainMenu and MenuItem events and properties


MainMenu Properties

MenuItems Collection of MenuItems for the MainMenu.

RightToLeft Used to display text from right to left. Useful for languages that are read from right to left.

MenuItem Properties

Checked Whether menu item appears checked (according to property RadioCheck). Default false, meaning that the menu item is not checked.

Index Item’s position in parent menu.

MenuItems Collection of submenu items for this menu item.


73

13.2 Menus

MergeOrder This property sets the position of menu item when parent menu merged with another menu.

MergeType This property takes a value of the MenuMerge enumeration. Specifies how parent menu merges with another menu. Possible values are Add, MergeItems, Remove and Replace.

RadioCheck If true, menu item appears as radio button (black circle) when checked; if false, menu item displays checkmark. Default false.

Shortcut Shortcut key for the menu item (i.e. Ctrl + F9 can be equivalent to clicking a specific item).

ShowShortcut If true, shortcut key shown beside menu item text. Default true.

Text Text to appear on menu item. To make an Alt access shortcut, precede a character with & (i.e. &File for File).


Click Raised when item is clicked or shortcut key is used. Default when double-clicked in designer.

Fig. 13.3 MainMenu and MenuItem properties and events.


Outline74

MenuTest.cs

1 // Fig 13.4: MenuTest.cs2 // Using menus to change font colors and styles.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 public class MenuTest : System.Windows.Forms.Form12 {13 // display label14 private System.Windows.Forms.Label displayLabel;15 16 // main menu (contains file and format menu)17 private System.Windows.Forms.MainMenu mainMenu;18 19 // file menu20 private System.Windows.Forms.MenuItem fileMenuItem;21 private System.Windows.Forms.MenuItem aboutMenuItem;22 private System.Windows.Forms.MenuItem exitMenuItem;23 24 // format menu25 private System.Windows.Forms.MenuItem formatMenuItem;26 27 // color submenu28 private System.Windows.Forms.MenuItem colorMenuItem;29 private System.Windows.Forms.MenuItem blackMenuItem;30 private System.Windows.Forms.MenuItem blueMenuItem;31 private System.Windows.Forms.MenuItem redMenuItem;32 private System.Windows.Forms.MenuItem greenMenuItem;33

About commandExit command

Color options


Outline75

MenuTest.cs

34 // font submenu35 private System.Windows.Forms.MenuItem timesMenuItem;36 private System.Windows.Forms.MenuItem courierMenuItem;37 private System.Windows.Forms.MenuItem comicMenuItem;38 private System.Windows.Forms.MenuItem boldMenuItem;39 private System.Windows.Forms.MenuItem italicMenuItem;40 private System.Windows.Forms.MenuItem fontMenuItem;41 42 private System.Windows.Forms.MenuItem separatorMenuItem;43 44 [STAThread]45 static void Main() 46 {47 Application.Run( new MenuTest() );48 }49 50 // display MessageBox51 private void aboutMenuItem_Click(52 object sender, System.EventArgs e )53 {54 MessageBox.Show( 55 "This is an example\nof using menus.",56 "About", MessageBoxButtons.OK, 57 MessageBoxIcon.Information );58 }59 60 // exit program61 private void exitMenuItem_Click(62 object sender, System.EventArgs e )63 {64 Application.Exit();65 }66

Font options

Style options

About eventhandler

Exit eventHandler


Outline76

MenuTest.cs

67 // reset color68 private void ClearColor()69 {70 // clear all checkmarks71 blackMenuItem.Checked = false;72 blueMenuItem.Checked = false;73 redMenuItem.Checked = false;74 greenMenuItem.Checked = false;75 }76 77 // update menu state and color display black78 private void blackMenuItem_Click(79 object sender, System.EventArgs e )80 {81 // reset checkmarks for color menu items82 ClearColor();83 84 // set color to black85 displayLabel.ForeColor = Color.Black;86 blackMenuItem.Checked = true;87 }88 89 // update menu state and color display blue90 private void blueMenuItem_Click(91 object sender, System.EventArgs e )92 {93 // reset checkmarks for color menu items94 ClearColor();95 96 // set color to blue97 displayLabel.ForeColor = Color.Blue;98 blueMenuItem.Checked = true;99 }100

Black eventhandler

Blue eventHandler


Outline77

MenuTest.cs

101 // update menu state and color display red102 private void redMenuItem_Click(103 object sender, System.EventArgs e )104 {105 // reset checkmarks for color menu items106 ClearColor();107 108 // set color to red109 displayLabel.ForeColor = Color.Red;110 redMenuItem.Checked = true;111 }112 113 // update menu state and color display green114 private void greenMenuItem_Click(115 object sender, System.EventArgs e )116 {117 // reset checkmarks for color menu items118 ClearColor();119 120 // set color to green121 displayLabel.ForeColor = Color.Green;122 greenMenuItem.Checked = true;123 }124 125 // reset font types126 private void ClearFont()127 {128 // clear all checkmarks129 timesMenuItem.Checked = false;130 courierMenuItem.Checked = false;131 comicMenuItem.Checked = false;132 }133

Red eventhandler

Green eventhandler


Outline78

MenuTest.cs

134 // update menu state and set font to Times135 private void timesMenuItem_Click(136 object sender, System.EventArgs e )137 {138 // reset checkmarks for font menu items139 ClearFont();140 141 // set Times New Roman font142 timesMenuItem.Checked = true;143 displayLabel.Font = new Font( 144 "Times New Roman", 14, displayLabel.Font.Style );145 }146 147 // update menu state and set font to Courier148 private void courierMenuItem_Click(149 object sender, System.EventArgs e )150 {151 // reset checkmarks for font menu items152 ClearFont();153 154 // set Courier font155 courierMenuItem.Checked = true;156 displayLabel.Font = new Font( 157 "Courier New", 14, displayLabel.Font.Style );158 }159 160 // update menu state and set font to Comic Sans MS161 private void comicMenuItem_Click(162 object sender, System.EventArgs e )163 {164 // reset checkmarks for font menu items165 ClearFont();166

Times New Roman event handler

Courier Newevent handler

Comic Sansevent handler


Outline79

MenuTest.cs

167 // set Comic Sans font168 comicMenuItem.Checked = true;169 displayLabel.Font = new Font( 170 "Comic Sans MS", 14, displayLabel.Font.Style );171 }172 173 // toggle checkmark and toggle bold style174 private void boldMenuItem_Click(175 object sender, System.EventArgs e )176 {177 // toggle checkmark178 boldMenuItem.Checked = !boldMenuItem.Checked;179 180 // use Xor to toggle bold, keep all other styles181 displayLabel.Font = new Font( 182 displayLabel.Font.FontFamily, 14,183 displayLabel.Font.Style ^ FontStyle.Bold );184 }185 186 // toggle checkmark and toggle italic style187 private void italicMenuItem_Click(188 object sender, System.EventArgs e)189 {190 // toggle checkmark191 italicMenuItem.Checked = !italicMenuItem.Checked;192 193 // use Xor to toggle bold, keep all other styles194 displayLabel.Font = new Font( 195 displayLabel.Font.FontFamily, 14,196 displayLabel.Font.Style ^ FontStyle.Italic );197 }198 199 } // end class MenuTest

Bold eventhandler

Italic eventhandler


Outline80

MenuTest.cs Program Output


81

13.3 LinkLabels

• Displays links to other objects– Uses event handlers to link to right file or program– Start method of Process class opens other programs

• Derived from class Label, inherits functionality


82

13.3 LinkLabels

Fig. 13.5 LinkLabel control in the design phase and in running program.

LinkLabel on a form

Hand image displayed when mouse cursor over a LinkLabel


83

13.3 LinkLabelsLinkLabel properties and events


Common Properties

ActiveLinkColor Specifies the color of the active link when clicked. Default is red.

LinkArea Specifies which portion of text in the LinkLabel is treated as part of the link.

LinkBehavior Specifies the link’s behavior, such as how the link appears when the mouse is placed over it.

LinkColor Specifies the original color of all links before they have been visited. Default is blue.

Links Lists the LinkLabel.Link objects, which are the links contained in the LinkLabel.

LinkVisited If True, link appears as if it were visited (its color is changed to that specified by property VisitedLinkColor). Default False.

Text Specifies the text to appear on the control.

UseMnemonic If True, & character in Text property acts as a shortcut (similar to the Alt shortcut in menus).

VisitedLinkColor Specifies the color of visited links. Default is Color.Purple.

Common Event (Delegate LinkLabelLinkClickedEventHandler, event arguments LinkLabelLinkClickedEventArgs)

LinkClicked Generated when link is clicked. Default when control is double-clicked in designer.


Outline84

LinkLabelTest.cs

1 // Fig. 13.7: LinkLabelTest.cs2 // Using LinkLabels to create hyperlinks.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 public class LinkLabelTest : System.Windows.Forms.Form12 {13 // linklabels to C: drive, www.deitel.com and Notepad14 private System.Windows.Forms.LinkLabel driveLinkLabel;15 private System.Windows.Forms.LinkLabel deitelLinkLabel;16 private System.Windows.Forms.LinkLabel notepadLinkLabel;17 18 [STAThread]19 static void Main() 20 {21 Application.Run( new LinkLabelTest() );22 }23 24 // browse C:\ drive25 private void driveLinkLabel_LinkClicked( object sender, 26 System.Windows.Forms.LinkLabelLinkClickedEventArgs e )27 {28 driveLinkLabel.LinkVisited = true;29 System.Diagnostics.Process.Start( "C:\\" );30 }31

C drive link

Notepad link

Deitel websitelink

C driveevent handler

Start method to open other programs


Outline85

LinkLabelTest.cs

32 // load www.deitel.com in Web broswer33 private void deitelLinkLabel_LinkClicked( object sender, 34 System.Windows.Forms.LinkLabelLinkClickedEventArgs e )35 {36 deitelLinkLabel.LinkVisited = true;37 System.Diagnostics.Process.Start( 38 "IExplore", "http://www.deitel.com" );39 }40 41 // run application Notepad42 private void notepadLinkLabel_LinkClicked( 43 object sender, 44 System.Windows.Forms.LinkLabelLinkClickedEventArgs e )45 {46 notepadLinkLabel.LinkVisited = true;47 48 // program called as if in run49 // menu and full path not needed50 System.Diagnostics.Process.Start( "notepad" );51 }52 53 } // end class LinkLabelTest

Deitel websiteevent handler

Notepad event handler


Outline86

LinkLabelTest.cs Program Output

Click on first LinkLabel to look at contents of C drive


Outline87


Click on second LinkLabel to go to the Web Site


Outline88


Click the third LinkLabel to open notepad


89

13.4 ListBoxes and CheckedListBoxes

• ListBoxes– Allow users to view and select from items on a list

– Static objects– SelectionMode property determines number of items

that can be selected

– Property Items returns all objects in list

– Property SelectedItem returns current selected item

– Property SelectedIndex returns index of selected item

– Property GetSelected returns true if property at given index is selected

– Use Add method to add to Items collection• myListBox.Items.Add(“myListItem”)


90

13.4 ListBoxes and CheckedListBoxes

• CheckedListBoxes– Extends ListBox by placing check boxes next to items

– Can select more than one object at one time


91

13.4.1 ListBoxes

• Class ListBoxTest– Allows users to add and remove items from ListBox– Uses event handlers to add to, remove from and clear list


92

13.4.2 CheckedListBoxes

• CheckedListBox derives from class ListBox– Can add to, remove from or clear list

– Can select multiple items from the list

– Properties CurrentValue and NewValue return state of object selected

– Properties CheckedItems and CheckedIndices return the objects and indices of selected items respectively


93

13.4 ListBoxes and CheckListBoxes

Fig. 13.8 ListBox and CheckedListBox on a form.

ListBox

Selected Items

Checked item

CheckedListBox

Scroll bars appear if necessary


94

13.4 ListBoxes and CheckListBoxesListBox properties, methods and events


Common Properties

Items Lists the collection of items within the ListBox.

MultiColumn Indicates whether the ListBox can break a list into multiple columns. Multiple columns are used to make vertical scroll bars unnecessary.

SelectedIndex Returns the index of the currently selected item. If the user selects multiple items, this method arbitrarily returns one of the selected indices; if no items have been selected, the method returns -1.

SelectedIndices Returns a collection of the indices of all currently selected items.

SelectedItem Returns a reference to the currently selected item (if multiple items are selected, it returns the item with the lowest index number).

SelectedItems Returns a collection of the currently selected item(s).

SelectionMode Determines the number of items that can be selected and the means through which multiple items can be selected. Values None, One, MultiSimple (multiple selection allowed) and MultiExtended (multiple selection allowed via a combination of arrow keys, mouse clicks and Shift and Control buttons).

Sorted Indicates whether items appear in alphabetical order. True causes alphabetization; default is False.

Common Method

GetSelected Takes an index, and returns True if the corresponding item is selected.


95


Fig. 13.10 String Collection Editor.


Outline96

ListBoxTest.cs

1 // Fig 13.11: ListBoxTest.cs2 // Program to add, remove and clear list box items.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 public class ListBoxTest : System.Windows.Forms.Form12 {13 // contains user-input list of elements14 private System.Windows.Forms.ListBox displayListBox;15 16 // user input textbox17 private System.Windows.Forms.TextBox inputTextBox;18 19 // add, remove, clear and exit command buttons20 private System.Windows.Forms.Button addButton;21 private System.Windows.Forms.Button removeButton;22 private System.Windows.Forms.Button clearButton;23 private System.Windows.Forms.Button exitButton;24 25 [STAThread]26 static void Main() 27 {28 Application.Run( new ListBoxTest() );29 }30

Display ListBox

Text field for input

Add button

Remove ButtonClear button

Exit button


Outline97

ListBoxTest.cs

31 // add new item (text from input box) 32 // and clear input box33 private void addButton_Click(34 object sender, System.EventArgs e )35 {36 displayListBox.Items.Add( inputTextBox.Text );37 inputTextBox.Clear();38 }39 40 // remove item if one selected41 private void removeButton_Click(42 object sender, System.EventArgs e )43 {44 // remove only if item selected45 if ( displayListBox.SelectedIndex != -1 )46 displayListBox.Items.RemoveAt( 47 displayListBox.SelectedIndex );48 }49 50 // clear all items51 private void clearButton_Click(52 object sender, System.EventArgs e )53 {54 displayListBox.Items.Clear();55 }56 57 // exit application58 private void exitButton_Click( 59 object sender, System.EventArgs e )60 {61 Application.Exit();62 }63 64 } // end class ListBoxTest

Add eventhandler

Add method

Remove method

Clear method

Test if item is selected

Exit


Outline98

ListBoxTest.cs Program Output


99


CheckedListBox properties, methods and events


Common Properties (All the ListBox properties and events are inherited by CheckedListBox.)

CheckedItems The collection of items that are checked. Not the same as the selected items, which are highlighted (but not necessarily checked).

CheckedIndices Returns indices for the items that are checked. Not the same as the selected indices.

SelectionMode Can only have values One (allows multiple selection) or None (does not allow multiple selection).

Common Methods

GetItemChecked Takes an index and returns true if corresponding item checked.

Common Events (Delegate ItemCheckEventHandler, event arguments ItemCheckEventArgs)

ItemCheck Raised when an item is checked or unchecked.

ItemCheckEventArgs Properties

CurrentValue Whether current item is checked or unchecked. Values Checked, Unchecked or Indeterminate.

Index Index of item that changed.

NewValue New state of item.

Fig. 13.12 CheckedListBox properties, methods and events.


Outline100

CheckedListBoxTest.cs

1 // Fig. 13.13: CheckedListBoxTest.cs2 // Using the checked list boxes to add items to a list box3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 public class CheckedListBoxTest : System.Windows.Forms.Form12 {13 // list of available book titles 14 private System.Windows.Forms.CheckedListBox 15 inputCheckedListBox;16 17 // user selection list18 private System.Windows.Forms.ListBox displayListBox;19 20 [STAThread]21 static void Main() 22 {23 Application.Run( new CheckedListBoxTest() );24 }25 26 // item about to change, 27 // add or remove from displayListBox28 private void inputCheckedListBox_ItemCheck(29 object sender, 30 System.Windows.Forms.ItemCheckEventArgs e )31 {32 // obtain reference of selected item33 string item = 34 inputCheckedListBox.SelectedItem.ToString();35

CheckedListBox

ListBox

ItemCheckevent handler


Outline101

CheckedListBoxTest.cs

Program Output

36 // if item checked add to listbox37 // otherwise remove from listbox38 if ( e.NewValue == CheckState.Checked )39 displayListBox.Items.Add( item );40 else41 displayListBox.Items.Remove( item );42 43 } // end method inputCheckedListBox_Click44 45 } // end class CheckedListBox

Add Item

Remove Item


102

13.5 ComboBoxes

• Combine TextBox and drop-down list• Add method adds object to collection• Properties:

– DropDownStyle: determines type of ComboBox– Items: returns objects in the list– SelectedItem: returns object selected– SelectedIndex: returns index of selected item


103

13.5 ComboBoxes

Fig. 13.14 Demonstrating a ComboBox.


104

13.5 ComboBoxes

ComboBox events and properties


Common Properties

DropDownStyle Determines the type of combo box. Value Simple means that the text portion is editable and the list portion is always visible. Value DropDown (the default) means that the text portion is editable but an arrow button must be clicked to see the list portion. Value DropDownList means that the text portion is not editable and the arrow button must be clicked to see the list portion.

Items Collection of items in the ComboBox control.

MaxDropDownItems Maximum number of items to display in the drop-down list (between 1 and 100). If value is exceeded, a scroll bar appears.

SelectedIndex Returns index of currently selected item. If there is no currently selected item, -1 is returned.

SelectedItem Returns reference to currently selected item.

Sorted If true, items appear in alphabetical order. Default false.


SelectedIndexChanged Raised when selected index changes (i.e., a check box has been checked or unchecked). Default when control double-clicked in designer.

Fig. 13.15 ComboBox properties and events.


Outline105

ComboBoxTest.cs

1 // Fig. 13.16: ComboBoxTest.cs2 // Using ComboBox to select shape to draw3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 public class ComboBoxTest : System.Windows.Forms.Form12 {13 // contains shape list (circle, square, ellipse, pie)14 private System.Windows.Forms.ComboBox imageComboBox;15 16 [STAThread]17 static void Main() 18 {19 Application.Run( new ComboBoxTest() );20 }21 22 // get selected index, draw shape23 private void imageComboBox_SelectedIndexChanged(24 object sender, System.EventArgs e )25 {26 // create graphics object, pen and brush27 Graphics myGraphics = base.CreateGraphics();28 29 // create Pen using color DarkRed30 Pen myPen = new Pen( Color.DarkRed );31 32 // create SolidBrush using color DarkRed33 SolidBrush mySolidBrush = 34 new SolidBrush( Color.DarkRed );35

Create ComboBox

SelectedIndexChanged event handler

Create graphics object

Create pen

Create brush


Outline106

ComboBoxTest.cs

36 // clear drawing area setting it to color White37 myGraphics.Clear( Color.White );38 39 // find index, draw proper shape40 switch ( imageComboBox.SelectedIndex )41 {42 case 0: // case circle is selected43 myGraphics.DrawEllipse( 44 myPen, 50, 50, 150, 150 );45 break;46 case 1: // case rectangle is selected47 myGraphics.DrawRectangle( 48 myPen, 50, 50, 150, 150 );49 break;50 case 2: // case ellipse is selected51 myGraphics.DrawEllipse( 52 myPen, 50, 85, 150, 115 );53 break;54 case 3: // case pie is selected55 myGraphics.DrawPie( 56 myPen, 50, 50, 150, 150, 0, 45 );57 break;58 case 4: // case filled circle is selected59 myGraphics.FillEllipse( 60 mySolidBrush, 50, 50, 150, 150 );61 break;62 case 5: // case filled rectangle is selected63 myGraphics.FillRectangle( 64 mySolidBrush, 50, 50, 150, 150 );65 break;66 case 6: // case filled ellipse is selected67 myGraphics.FillEllipse(68 mySolidBrush, 50, 85, 150, 115 );69 break;

Switch statement to determine correct object to draw

Draw object


Outline107

ComboBoxTest.cs

Program Output

70 case 7: // case filled pie is selected71 myGraphics.FillPie(72 mySolidBrush, 50, 50, 150, 150, 0, 45 );73 break;74 75 } // end switch76 77 } // end method imageComboBox_SelectedIndexChanged78 79 } // end class ComboBoxTest


Outline108

ComboBoxTest.cs Program Output


109

13.6 TreeViews

• Displays nodes hierarchically• Parent nodes have children• The first parent node is called the root• Use Add method to add nodes


110

13.6 TreeView

Fig. 13.17 Displaying a sample tree in a TreeView.

Click to expand node, displaying child nodes

Root node

Child nodes

Click to collapse node, hiding child nodes


111

13.6 TreeView

TreeView properties and events


Common

Properties

CheckBoxes Indicates whether checkboxes appear next to nodes. True displays

checkboxes. Default is False.

ImageList Indicates the ImageList used to display icons by the nodes. An

ImageList is a collection that contains a number of Image objects.

Nodes Lists the collection of TreeNodes in the control. Contains

methods Add (adds a TreeNode object), Clear (deletes the

entire collection) and Remove (deletes a specific node). Removing a parent node deletes all its children.

SelectedNode Currently selected node.

Common Event (Delegate TreeViewEventHandler, event arguments TreeViewEventArgs)

AfterSelect Generated after selected node changes. Default when double-clicked in designer.

Fig. 13.18 TreeView properties and events.


112

13.6 TreeViewTreeNode properties and methods


Common Properties

Checked Indicates whether the TreeNode is checked.

(CheckBoxes property must be set to True in parent

TreeView.)

FirstNode Specifies the first node in the Nodes collection (i.e., first child in tree).

FullPath Indicates the path of the node, starting at the root of the tree.

ImageIndex Specifies the index of the image to be shown when the node is deselected.

LastNode Specifies the last node in the Nodes collection (i.e., last child in tree).

NextNode Next sibling node.

Nodes The collection of TreeNodes contained in the current node

(i.e., all the children of the current node). Contains methods Add

(adds a TreeNode object), Clear (deletes the entire

collection) and Remove (deletes a specific node). Removing a parent node deletes all its children.

PrevNode Indicates the previous sibling node.

SelectedImageIndex

Specifies the index of the image to use when the node is selected.

Text Specifies the text to display in the TreeView.

Common Methods Collapse Collapses a node.

Expand Expands a node.

ExpandAll Expands all the children of a node.

GetNodeCount Returns the number of child nodes.

Fig. 13.19 TreeNode properties and methods.


113

13.6 TreeView

Fig. 13.20 TreeNode Editor.


Outline114

TreeViewDirectoryStructureTest.cs

1 // Fig. 13.21: TreeViewDirectoryStructureTest.cs2 // Using TreeView to display directory structure3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 using System.IO;11 12 public class TreeViewDirectoryStructureTest 13 : System.Windows.Forms.Form14 {15 // contains view of c: drive directory structure16 private System.Windows.Forms.TreeView directoryTreeView;17 18 [STAThread]19 static void Main() 20 {21 Application.Run(22 new TreeViewDirectoryStructureTest() );23 }24 25 public void PopulateTreeView( 26 string directoryValue, TreeNode parentNode )27 {28 // populate current node with subdirectories29 string[] directoryArray = 30 Directory.GetDirectories( directoryValue );31

Class that creates children of root

Get subdirectories of root


Outline115


32 // populate current node with subdirectories33 try34 {35 if ( directoryArray.Length != 0 )36 {37 // for every subdirectory, create new TreeNode,38 // add as child of current node and recursively39 // populate child nodes with subdirectories40 foreach ( string directory in directoryArray )41 {42 // create TreeNode for current directory43 TreeNode myNode = new TreeNode( directory );44 45 // add current directory node to parent node46 parentNode.Nodes.Add( myNode );47 48 // recursively populate every subdirectory49 PopulateTreeView( directory, myNode );50 }51 52 } // end if53 }54 55 // catch exception56 catch ( UnauthorizedAccessException )57 { 58 parentNode.Nodes.Add( "Access denied" );59 }60 61 } // end PopulateTreeView 62

Catches security exception

Create new node

Recursive call to finish tree


Outline116


63 // called by system when form loads64 private void TreeViewDirectoryStructureTest_Load(65 object sender, System.EventArgs e)66 {67 // add c:\ drive to directoryTreeView and 68 // insert its subfolders69 directoryTreeView.Nodes.Add( "C:\\" );70 PopulateTreeView( 71 "C:\\", directoryTreeView.Nodes[ 0 ] );72 } 73 74 } // end class TreeViewDirectoryStructure

Create root


Outline117

TreeViewDirectoryStructureTest.cs Program Output


118

13.7 ListViews

• Displays list of items– Can select one or more items from list

– Displays icons to go along with items


119

13.7 ListViewsListView events and properties


Common

Properties

Activation Determines how the user activates an item. This property takes a value in the ItemActivation enumeration. Possible values are

OneClick (single-click activation), TwoClick (double-click activation, item changes color when selected) and Standard (double-click activation).

CheckBoxes Indicates whether items appear with checkboxes. True displays

checkboxes. Default is False.

LargeImageList

Indicates the ImageList used when displaying large icons.

Items Returns the collection of ListViewItems in the control.

MultiSelect Determines whether multiple selection is allowed. Default is True, which enables multiple selection.

SelectedItems Lists the collection of currently selected items.

SmallImageList

Specifies the ImageList used when displaying small icons.

View Determines appearance of ListViewItems. Values

LargeIcon (large icon displayed, items can be in multiple

columns), SmallIcon (small icon displayed), List (small

icons displayed, items appear in a single column) and Details

(like List, but multiple columns of information can be displayed per item).

Common Event (Delegate EventHandler, event arguments EventArgs)

ItemActivate Generated when an item in the ListView is activated. Does not specify which item is activated.


120

13.7 ListViews

Fig. 13.23 Image Collection Editor window for an ImageList component.


Outline121

ListViewTest.cs

1 // Fig. 13.24: ListViewTest.cs2 // Displaying directories and their contents in ListView.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 using System.IO;11 12 public class ListViewTest : System.Windows.Forms.Form13 {14 // display labels for current location 15 // in directory tree 16 private System.Windows.Forms.Label currentLabel;17 private System.Windows.Forms.Label displayLabel;18 19 // display contents of current directory20 private System.Windows.Forms.ListView browserListView;21 22 // specifies images for file icons and folder icons23 private System.Windows.Forms.ImageList fileFolder;24 25 // get current directory26 string currentDirectory = 27 Directory.GetCurrentDirectory();28 29 [STAThread]30 static void Main() 31 {32 Application.Run( new ListViewTest() );33 }34

Create Image List

Load the current directory


Outline122

ListViewTest.cs

35 // browse directory user clicked or go up one level36 private void browserListView_Click(37 object sender, System.EventArgs e )38 {39 // ensure item selected40 if ( browserListView.SelectedItems.Count != 0 )41 {42 // if first item selected, go up one level43 if ( browserListView.Items[ 0 ].Selected )44 {45 // create DirectoryInfo object for directory46 DirectoryInfo directoryObject = 47 new DirectoryInfo( currentDirectory );48 49 // if directory has parent, load it50 if ( directoryObject.Parent != null )51 LoadFilesInDirectory( 52 directoryObject.Parent.FullName );53 }54 55 // selected directory or file56 else57 {58 // directory or file chosen59 string chosen = 60 browserListView.SelectedItems[ 0 ].Text;61 62 // if item selected is directory63 if ( Directory.Exists( currentDirectory + 64 "\\" + chosen ) )65 {

Test to see if at root

Return parent ofcurrent directory

Check if selected item is directory

Test if item is selected

If first item selected go up one level

Make directory information


Outline123

ListViewTest.cs

66 // load subdirectory67 // if in c:\, do not need '\', 68 // otherwise we do69 if ( currentDirectory == "C:\\" )70 LoadFilesInDirectory( 71 currentDirectory + chosen );72 else73 LoadFilesInDirectory( 74 currentDirectory + "\\" + chosen );75 } //end if76 77 } // end else78 79 // update displayLabel80 displayLabel.Text = currentDirectory;81 82 } // end if83 84 } // end method browserListView_Click85 86 // display files/subdirectories of current directory87 public void LoadFilesInDirectory( 88 string currentDirectoryValue )89 {90 // load directory information and display91 try92 {93 // clear ListView and set first item94 browserListView.Items.Clear();95 browserListView.Items.Add( "Go Up One Level" );96

Class to load files in current directory

Update to display current directory

Load subdirectory


Outline124

ListViewTest.cs

97 // update current directory98 currentDirectory = currentDirectoryValue;99 DirectoryInfo newCurrentDirectory = 100 new DirectoryInfo( currentDirectory );101 102 // put files and directories into arrays103 DirectoryInfo[] directoryArray = 104 newCurrentDirectory.GetDirectories();105 106 FileInfo[] fileArray = 107 newCurrentDirectory.GetFiles();108 109 // add directory names to ListView110 foreach ( DirectoryInfo dir in directoryArray )111 {112 // add directory to ListView113 ListViewItem newDirectoryItem = 114 browserListView.Items.Add( dir.Name );115 116 // set directory image117 newDirectoryItem.ImageIndex = 0;118 }119 120 // add file names to ListView121 foreach ( FileInfo file in fileArray )122 {123 // add file to ListView124 ListViewItem newFileItem = 125 browserListView.Items.Add( file.Name );126 127 newFileItem.ImageIndex = 1; // set file image128 }129 } // end try130

Get subdirectories of current directory

Get files of current directory

Add directory to list

Add file to list


Outline125

ListViewTest.cs

131 // access denied132 catch ( UnauthorizedAccessException exception )133 {134 MessageBox.Show( 135 "Warning: Some fields may not be " +136 "visible due to permission settings", 137 "Attention", 0, MessageBoxIcon.Warning );138 }139 140 } // end method LoadFilesInDirectory141 142 // handle load event when Form displayed for first time143 private void ListViewTest_Load(144 object sender, System.EventArgs e )145 {146 // set image list147 Image folderImage = Image.FromFile( 148 currentDirectory + "\\images\\folder.bmp" );149 150 Image fileImage = Image.FromFile( currentDirectory +151 "\\images\\file.bmp" );152 153 fileFolder.Images.Add( folderImage );154 fileFolder.Images.Add( fileImage );155 156 // load current directory into browserListView157 LoadFilesInDirectory( currentDirectory );158 displayLabel.Text = currentDirectory;159 160 } // end method ListViewTest_Load161 162 } // end class ListViewTest

Security exceptionhandler

Load Images


Outline126

ListViewTest.cs Program Output


127

13.8 TabControl

• Creates tabbed windows• Windows called TabPage objects

– TabPages can have controls– Tabpages have own Click event for when tab is clicked


128

13.8 Tab Controls

Fig. 13.25 Tabbed pages in Visual Studio .NET.

Tab pages


129

13.8 Tab Controls

Fig. 13.26 Example TabControl with TabPages.

TabPage

TabControl

Controls in TabPage


130

13.8 Tab Controls

Fig. 13.27 Adding TabPages to the TabControl.


131

13.8 Tab Controls

TabControl properties and events


Common Properties

ImageList Specifies images to be displayed on a tab.

ItemSize Specifies tab size.

MultiLine Indicates whether multiple rows of tabs can be displayed.

SelectedIndex Indicates index of TabPage that is currently selected.

SelectedTab Indicates the TabPage that is currently selected.

TabCount Returns the number of tabs.

TabPages Gets the collection of TabPages within our

TabControl.


SelectedIndexChanged

Generated when SelectedIndex changes (i.e., another

TabPage is selected).

Fig. 13.28 TabControl properties and events.


Outline132

UsingTabs.cs

1 // Fig. 13.29: UsingTabs.cs2 // Using TabControl to display various font settings.3 4 using System;5 using System.Drawing;6 using System.Collections;7 using System.ComponentModel;8 using System.Windows.Forms;9 using System.Data;10 11 public class UsingTabs : System.Windows.Forms.Form12 {13 // output label reflects text changes14 private System.Windows.Forms.Label displayLabel;15 16 // table control containing table pages colorTabPage,17 // sizeTabPage, messageTabPage and aboutTabPage18 private System.Windows.Forms.TabControl 19 optionsTabControl;20 21 // table page containing color options22 private System.Windows.Forms.TabPage colorTabPage;23 private System.Windows.Forms.RadioButton 24 greenRadioButton;25 private System.Windows.Forms.RadioButton redRadioButton;26 private System.Windows.Forms.RadioButton 27 blackRadioButton;28

Color tab

Color buttons for

color tab


Outline133

UsingTabs.cs

29 // table page containing font size options30 private System.Windows.Forms.TabPage sizeTabPage;31 private System.Windows.Forms.RadioButton 32 size20RadioButton;33 private System.Windows.Forms.RadioButton 34 size16RadioButton;35 private System.Windows.Forms.RadioButton 36 size12RadioButton;37 38 // table page containing text display options39 private System.Windows.Forms.TabPage messageTabPage;40 private System.Windows.Forms.RadioButton 41 goodByeRadioButton;42 private System.Windows.Forms.RadioButton 43 helloRadioButton;44 45 // table page containing about message46 private System.Windows.Forms.TabPage aboutTabPage;47 private System.Windows.Forms.Label messageLabel;48 49 [STAThread]50 static void Main() 51 {52 Application.Run( new UsingTabs() );53 }54 55 // event handler for black color radio button56 private void blackRadioButton_CheckedChanged(57 object sender, System.EventArgs e )58 {59 displayLabel.ForeColor = Color.Black;60 }61

Size tab

Size buttons

Message tab

About tab

Event handler


Outline134

UsingTabs.cs

62 // event handler for red color radio button63 private void redRadioButton_CheckedChanged(64 object sender, System.EventArgs e )65 {66 displayLabel.ForeColor = Color.Red;67 }68 69 // event handler for green color radio button70 private void greenRadioButton_CheckedChanged(71 object sender, System.EventArgs e )72 {73 displayLabel.ForeColor = Color.Green;74 }75 76 // event handler for size 12 radio button77 private void size12RadioButton_CheckedChanged(78 object sender, System.EventArgs e )79 {80 displayLabel.Font = 81 new Font( displayLabel.Font.Name, 12 );82 }83 84 // event handler for size 16 radio button85 private void size16RadioButton_CheckedChanged(86 object sender, System.EventArgs e )87 {88 displayLabel.Font = 89 new Font( displayLabel.Font.Name, 16 );90 }91

Event handlers


Outline135

UsingTabs.cs

92 // event handler for size 20 radio button93 private void size20RadioButton_CheckedChanged(94 object sender, System.EventArgs e )95 {96 displayLabel.Font = 97 new Font( displayLabel.Font.Name, 20 ); 98 }99 100 // event handler for message "Hello!" radio button101 private void helloRadioButton_CheckedChanged(102 object sender, System.EventArgs e )103 {104 displayLabel.Text = "Hello!";105 }106 107 // event handler for message "Goodbye!" radio button108 private void goodByeRadioButton_CheckedChanged(109 object sender, System.EventArgs e )110 {111 displayLabel.Text = "Goodbye!";112 }113 114 } // end class UsingTabs

Event handlers


Outline136

UsingTabs.cs Program Output


137

13.9 Multiple-Document Interface Windows

• Users can edit multiple documents at once• Usually more complex then single-document-

interface applications• Application window called parent, others child• Parent and child menus can be merged

– Based on MergeOrder property

• Child windows can be arranged in parent window:– Tiled windows: completely fill parent, no overlap

• Either horizontal or vertical

– Cascaded windows: overlap, same size, display title bar

– ArrangeIcons: arranges icons for minimized windows


138

13.9 Multiple Document Interface (MDI) Windows

Fig. 13.30 MDI parent and MDI child.

MDI parent

MDI child

MDI child


139


Fig. 13.31 SDI and MDI forms.

Single Document Interface (SDI) Multiple Document Interface (MDI)


140


MDI Form events and properties


Common MDI Child

Properties

IsMdiChild Indicates whether the Form is an MDI child. If True, Form is an MDI child (read-only property).

MdiParent Specifies the MDI parent Form of the child.

Common MDI Parent Properties

ActiveMdiChild Returns the Form that is the currently active MDI child

(returns null if no children are active).

IsMdiContainer Indicates whether a Form can be an MDI. If True, the

Form can be an MDI parent. Default is False.

MdiChildren Returns the MDI children as an array of Forms.

Common Method LayoutMdi Determines the display of child forms on an MDI parent. Takes

as a parameter an MdiLayout enumeration with possible

values ArrangeIcons, Cascade,

TileHorizontal and TileVertical. Figure 13.35 depicts the effects of these values.


MdiChildActivate Generated when an MDI child is closed or activated.

Fig. 13.32 MDI parent and MDI child events and properties.


141


Parent’s icons: minimize, maximize and close

Maximized child’s icons: minimize, restore and close

Minimized child’s icons: restore, maximize and close

Parent’s title bar displays maximized child

Fig. 13.33 Minimized and maximized child windows.


142


Fig. 13.34 Using MenuItem property MdiList.

Separator bar and child windows

9 or more child windows enables the More Windows... option

Child windows list


143


Fig. 13.35 LayoutMdi enumeration values (Part 1).

ArrangeIcons Cascade


144


Fig. 13.35 LayoutMdi enumeration values (Part 2).

TileHorizontal

TileVertical


Outline145

UsingMDI.cs

1 // Fig. 13.36: UsingMDI.cs2 // Demonstrating use of MDI parent and child windows.3 using System;4 using System.Drawing;5 using System.Collections;6 using System.ComponentModel;7 using System.Windows.Forms;8 using System.Data;9 10 public class UsingMDI : System.Windows.Forms.Form11 {12 private System.Windows.Forms.MainMenu mainMenu1;13 private System.Windows.Forms.MenuItem fileMenuItem;14 private System.Windows.Forms.MenuItem newMenuItem;15 private System.Windows.Forms.MenuItem child1MenuItem;16 private System.Windows.Forms.MenuItem child2MenuItem;17 private System.Windows.Forms.MenuItem child3MenuItem;18 private System.Windows.Forms.MenuItem exitMenuItem;19 private System.Windows.Forms.MenuItem formatMenuItem;20 private System.Windows.Forms.MenuItem cascadeMenuItem;21 private System.Windows.Forms.MenuItem 22 tileHorizontalMenuItem;23 private System.Windows.Forms.MenuItem 24 tileVerticalMenuItem;25 26 [STAThread]27 static void Main() 28 {29 Application.Run( new UsingMDI() );30 }31

File menu

New submenu

Exit submenuFormant menu

Cascade option

Tiling options


Outline146

UsingMDI.cs

32 // create Child 1 when menu clicked33 private void child1MenuItem_Click(34 object sender, System.EventArgs e )35 {36 // create new child37 Child formChild = new Child( "Child 1", 38 "\\images\\csharphtp1.jpg" );39 formChild.MdiParent = this; // set parent40 formChild.Show(); // display child41 }42 43 // create Child 2 when menu clicked44 private void child2MenuItem_Click(45 object sender, System.EventArgs e )46 {47 // create new child48 Child formChild = new Child( "Child 2", 49 "\\images\\vbnethtp2.jpg" );50 formChild.MdiParent = this; // set parent51 formChild.Show(); // display child52 }53 54 // create Child 3 when menu clicked55 private void child3MenuItem_Click(56 object sender, System.EventArgs e )57 {58 // create new child59 Child formChild = new Child( "Child 3", 60 "\\images\\pythonhtp1.jpg" );61 formChild.MdiParent = this; // set parent62 formChild.Show(); // display child63 }64

Create child windows


Outline147

UsingMDI.cs

65 // exit application66 private void exitMenuItem_Click(67 object sender, System.EventArgs e )68 {69 Application.Exit();70 }71 72 // set cascade layout73 private void cascadeMenuItem_Click(74 object sender, System.EventArgs e )75 {76 this.LayoutMdi( MdiLayout.Cascade );77 }78 79 // set TileHorizontal layout80 private void tileHorizontalMenuItem_Click(81 object sender, System.EventArgs e )82 {83 this.LayoutMdi( MdiLayout.TileHorizontal );84 }85 86 // set TileVertical layout87 private void tileVerticalMenuItem_Click(88 object sender, System.EventArgs e )89 {90 this.LayoutMdi( MdiLayout.TileVertical );91 }92 93 } // end class UsingMDI

Cascade

Tile horizontally

Tile vertically


Outline148

UsingMDI.cs Program Output


Outline149

Child.cs

1 // Fig. 13.37: Child.cs2 // Child window of MDI parent.3 using System;4 using System.Drawing;5 using System.Collections;6 using System.ComponentModel;7 using System.Windows.Forms;8 using System.IO;9 10 public class Child : System.Windows.Forms.Form11 {12 private System.Windows.Forms.PictureBox pictureBox;13 14 public Child( string title, string fileName )15 {16 // Required for Windows Form Designer support17 InitializeComponent();18 19 Text = title; // set title text20 21 // set image to display in pictureBox22 pictureBox.Image = Image.FromFile( 23 Directory.GetCurrentDirectory() + fileName );24 }25 }

Create picture box

Display title

Display picture

Child class


150

13.10 Visual Inheritance

• Create Form by inheriting from another Form– Derived Form inherits functionality of base Form– Derived Form inherits visual aspects of base Form


Outline151

VisualInheritance.cs

1 // Fig. 13.38: VisualInheritance.cs2 // Base Form for use with visual inheritance3 using System;4 using System.Drawing;5 using System.Collections;6 using System.ComponentModel;7 using System.Windows.Forms;8 using System.Data;9 10 public class VisualInheritance : System.Windows.Forms.Form11 {12 private System.Windows.Forms.Label bugsLabel;13 private System.Windows.Forms.Button learnMoreButton;14 private System.Windows.Forms.Label label1;15 16 [STAThread]17 static void Main() 18 {19 Application.Run( new VisualInheritance() );20 }21 22 private void learnMoreButton_Click( object sender, 23 System.EventArgs e )24 {25 MessageBox.Show( 26 "Bugs, Bugs, Bugs is a product of Bug2Bug.com", 27 "Learn More", MessageBoxButtons.OK, 28 MessageBoxIcon.Information );29 }30 }

Learn More display method


Outline152

VisualInheritance.csProgram Output


153

13.11 User-Defined Controls

Fig. 13.39 Visual Inheritance through the Form Designer.


Outline154

VisualInheritanceTest.cs

1 // Fig. 13.40: VisualInheritanceTest.cs2 // Derived Form using visual inheritance.3 using System;4 using System.Collections;5 using System.ComponentModel;6 using System.Drawing;7 using System.Windows.Forms;8 9 public class VisualInheritanceTest : 10 VisualInheritance.VisualInheritance11 {12 private System.Windows.Forms.Button learnProgramButton;13 14 // invoke when user clicks Learn the Program Button15 private void learnProgramButton_Click( object sender, 16 System.EventArgs e )17 {18 MessageBox.Show(19 "This program was created by Deitel & Associates",20 "Learn the Program", MessageBoxButtons.OK, 21 MessageBoxIcon.Information );22 }23 24 public static void Main( string[] args )25 {26 Application.Run( new VisualInheritanceTest() );27 }28 }

VisualInheritanceTest class is derived from VisualInheritance class

Display message box


Outline155

VisualInheritanceTest.csProgram Output

Derived class cannot modify these controls

Derived class can modify this control


156


• Custom controls that inherit from other classes– Ex: can change appearance of a label


157


Custom Control Techniques and PaintEventArgs Properties

Description

Inherit from Windows Forms control

Add functionality to a preexisting control. If overriding method OnPaint, call base class OnPaint. Can only add to the original control appearance, not redesign it.

Create a UserControl Create a UserControl composed of multiple preexisting controls (and combine their functionality). Cannot override OnPaint methods of custom controls. Instead,

add drawing code to a Paint event handler. Can only add to the original control appearance, not redesign it.

Inherit from class Control Define a brand-new control. Override OnPaint method,

call base class method OnPaint and include methods to draw the control. Can customize control appearance and functionality.

PaintEventArgs

Properties Use this object inside method OnPaint or Paint to draw on the control.

Graphics Indicates the graphics object of control. Used to draw on control.

ClipRectangle Specifies the rectangle indicating boundary of control.

Fig. 13.41 Custom control creation.


Outline158

ClockUserControl.cs

1 // Fig. 13.42: ClockUserControl.cs2 // User-defined control with a timer and a label.3 4 using System;5 using System.Collections;6 using System.ComponentModel;7 using System.Drawing;8 using System.Data;9 using System.Windows.Forms;10 11 public class ClockUserControl 12 : System.Windows.Forms.UserControl13 {14 private System.Windows.Forms.Timer clockTimer;15 private System.Windows.Forms.Label displayLabel;16 17 // update label at every tick18 private void clockTimer_Tick(19 object sender, System.EventArgs e )20 {21 // get current time (Now), convert to string22 displayLabel.Text = DateTime.Now.ToLongTimeString();23 24 } // end method clockTimer_Tick25 26 } // end class ClockUserControl

Timer

Label

Update label method

Display current time


159


Fig. 13.43 Custom-control creation.


160


Fig. 13.44 Project properties dialog.


161


Fig. 13.45 Custom control added to the ToolBox.


162


Fig. 13.46 Custom control added to a Form.

New Toolbox iconNewly inserted control


163

Homework and Practical

• Homework– Chapter 12 Self-review exercises

– Chapter 13 Self-review exercises

• Practical– Exercise 12.3 (page 518)

– Exercise 12.6 (page 518)





2002 prentice hall. all rights reserved. 1 week 7: gui questions from last lecture –exception...

Documents