debugging and menus part07dbg --- solving the problem, debugging in break time, menus, common...
TRANSCRIPT
Debugging and Menus
Part07dbg --- Solving the problem, Debugging in Break time, Menus, Common Dialogs, and
User-written methods
2
Carefully Plan the Solution
• Understand the inputs and outputs of desired solution.• Draw a sketch of proposed solution showing
placement of controls.• Assign meaningful names to controls using 3
character prefixes.• Decide what variables (and appropriate scope) will be
required.• Choose test data and do hand/calculator calculations
so that you know what answers should be produced by the program.
3
3 Modes of Operation
• Design Time --- before application is run• Run Time --- when application is running• Break Time --- when run time is suspended, for
the purpose of debugging
4
Design Time
• Add controls to form via Designer.• Set/review Property values for controls via
Property Window.• Add code to “handle” various events and
set/change Property values (at runtime) via Code Window.
5
Run Time
• Code executed in event handler methods/functions can– change Property values for controls (Visible,
ForeColor, BackColor, Text).– run methods to reset Focus(), Clear() contents, write
variable/control values to the Output Window (via Debug.Writeline()) etc.
– perform calculations/comparisons of variable values. – display variable values in controls. – handle various events.
6
How to Debug Code without using Break Time
• Trace through your program by hand, recording variable values (desk-checking).
• Insert statements into code that will print messages and/or values to the Output Window, so you see variable values, without preparing values for output in controls.
System.Diagnostics.Debug.WriteLine(totRed); //print value of variable ---or---
using System.Diagnostics; //add at top of programDebug.WriteLine(totRed); //print value of variable ---or---
Console.WriteLine(totRed); //print value of variable
8
Setting Break Points
• To set a breakpoint in your code, which will suspend execution before designated statement, – click in the light gray border to the left of the line of
code.– press F9– Debug, New Breakpoint in the menu
9
Helpful Windows during Break Time
• Code Window– Hover mouse over variable/control name to display its
value.
• Locals Window– View values of local variables.– Class-level variables values can be viewed by clicking
the + in front of this.
• Autos Window– Values of all variables in use near the highlighted line.
10
Stepping through Code
• Continue --- continue running (till next breakpoint)
• Step Into --- execute 1 statement• Step Over --- execute 1 statement but
don’t branch into any called method• Step Out --- advance rapidly until reach
end of function/method, then back to 1 statement at a time execution
• Restart --- start back at the beginning• Stop Debugging
11
Removing Breakpoints
• To clear one breakpoint, position cursor and – click in gray border to left of designated line of code.– press F9.– choose Debug, Toggle Breakpoint from menu.
• To clear several breakpoints, choose Debug, Delete All Breakpoints from menu.
12
Let’s Try Debugging Together
• Get the Ch04DebugCSR 2005 project folder from Dee Gudmundsen CIS205 on drive z:
• A zipped file, Ch04DebugCSR.zip, containing this project folder is also posted on my website in the in part07.zip of the Demonstration files section.
• This problem has error(s), which we will discover using the Debugging facilities of Visual Studio.NET.
14
The MenuStrip Control
• The MenuStrip control can be used to add a menu to the top of a form.
• The MenuStrip control is new in VS.NET 2005. It replaces the MainMenu component in earlier versions of VS.NET.
• MainMenu components did not occupy the client area of the form. The client area of a form is the size of the form, minus the nonclient elements such as scroll bars, borders, and title bars.
• MenuStrip controls do occupy the client area of the form.
15
The Client Area
• The client area, defined by the ClientSize object and its Height and Width properties is that part of the form that can host controls.
ClientSize.Width
Cli
entS
ize.
Hei
gh
t
16
MainMenu
• The icon for a MenuStrip control resides in the component tray area of the Designer.
• The MenuStrip control supports a point and click editor for constructing a menu with MenuItems.
• MenuItems are essentially buttons that are contained in the Items collection associated with the MenuStrip control.
17
MenuItems
• MenuItems are added to a MenuStrip by typing the Text property of a MenuItem in a position suggested by the menu editor.
18
Renaming Menu Items
• MenuItems are controls and should be given meaningful names.
• A good organizational strategy is to use a compound name consisting of the menu (top line) name and the MenuItem name.
• Use the prefix mnu for MenuItems.
19
Coding Handlers for MenuItems
• The Click event is the default event for MenuItems and their handler functions may be created using the same techniques as with Buttons.
• We will add code to our MenuItem Click handler functions to assign different values to the BackColor property of the form.
SimpleMenu
20
Adding Menu Access () Keys
• Access (Hot) keys allow users to open menus and select menu items using the keyboard.
• Menus are opened by pressing Alt and the appropriate hot key.
• MenuItems are selected by simply pressing the hot key.
• Access (Hot) keys are created by inserting an & character ahead of the character (that will act as a hot key) in the Text property of a MenuItem.
21
Hot Keys at Run Time
• Hot keys appear underlined at run time.• Hot keys in menus appear when the Alt key is
pressed.• Hot keys in open menus (MenuItems) appear
automatically.
HotKeys
22
Menu Shortcuts
• Shortcuts allow selection of a menu item without even opening a menu.
• Shortcuts are assigned to function keys or control key combinations (e.g. ctrl + C).
• Shortcuts are applied to MenuItems by assigning a value to the Shortcut property of the MenuItem.
23
Menu Shortcuts
• An additional MenuItem property, ShowShortcuts, sets whether the shortcut will appear on the menu at run time.
• Curiously, shortcuts are never visible at design time.
capture of shortcuts at run time
ShortCuts
InvisibleShortCuts
24
Menu Branching
• Branched menus are easily created by typing new MenuItem Text properties in the indicated positions.
• Naming conventions should recognize the node at which the menu branches.
BranchedMenu
25
Menu Separators
• Menu separators appear as simple horizontal lines to arrange menu items into groups.
• They are created by simply typing a hyphen for the Text Property of a MenuItem or right-clicking and choose Insert Separator.
26
ContextMenuStrips
• Rather than appear at the top of a form, ContextMenuStrips “pop up” when an object is right-clicked.
• Choose the ContextMenuStrip control from the Toolbox. Edit in the same way as a MenuStrip.
• Use cmu as the prefix for Context MenuItems• Associate the ContextMenuStrip with a control
by setting the ContextMenuStrip property of the control. ContextMenus
ContextMenusDBG
27
Alternate Main Menus
• Multiple MenuStrip controls may be added to a form.
• To switch among the MenuStrips available:1. assign the desired MenuStrip name to the
MainMenuStrip property of the form.
2. set the Visible property of desired MenuStrip to true and the Visible property of undesired MenuStrip to false.
AlternateMainMenus
28
Using Common Dialog Boxes
• C# provides predefined standard dialog boxes for such tasks as specifying colors and fonts, and opening and saving.
• Use the common dialog controls in the Dialogs section of the Toolbox.
• When you double-click one of these dialogs, it will be added to the component tray below your form.
29
Common Dialog Objects
• Use the supplied object name (ex. FontDialog1). • To change the font of lblOutput via FontDialog1,
include the following code in the appropriate event handler:1. Display the current property setting in the dialog.
FontDialog1.Font = lblOutput.Font; //display current label font as selected font of dialog
2. Display the dialog FontDialog1.ShowDialog(); //display the dialog
3. After user makes a selection from dialog, assign user selection to the appropriate property.lblOutput.Font = FontDialog1.Font; //set label font to new user
selected font
30
Let’s Do a Problem Together
• Make a copy of Piecework complete and paste it into your CIS205 folder on the hard drive.
• Add the following menu structure to this existing problem:
File Edit Help
Calculate Pay Clear About
Summary ---------
Exit Font …
Color …
31
Writing functions/methods
• So far the only functions/methods we have been working with are functions/methods that handle events; the skeleton of these functions/methods were typed for us when we double-clicked a control.
• You will recall from C++ or Java, that it is often convenient to write our own functions/methods:– To break a problem into smaller parts– Because some code will be executed in more than 1
place (reusable code)
• Before writing our own functions in C#, let’s review C++ and Java function/method syntax.
32
C++ Functions
• C++ functions consist of 2 parts:– Function prototype --- declares the function, specifies
data type of returned value, lists number of parameters and their data types
– Function definition --- function header (copy of prototype without ;) plus actual code to be executed
• These could be written within the source program file or contained in separate .cpp and .h files. Remember, a #include statement is necessary to incorporate the .h file when storing function definitions in separate files.
33
C++ Function Syntax
Syntax:return-type functionName(data-type variable1, data-type
variable2, …)
Example 1://function prototypedouble calcInterest (int y, double p, double r);
//function definitiondouble calcInterest(int y, double p, double r){ double temp; temp = p * r * y; return temp;}
//function call in main()interest = calcInterest (years, principal, rate);
34
Another C++ Function Example
Syntax: return-type functionName(data-type variable1, data-type
variable2, …)
Example2://function prototypevoid printLoanInfo(int y, double p, double r, double i);
//function definitionvoid printLoanInfo(int y, double p, double r, double i){ cout << “You will have to pay $” << i <<
<< “ interest on your loan of $” << p << “ for a term of ” << y << “ years at a rate of
” << r << “%.\n”;
}
//function call in main()printLoanInfo(years, principal, rate, interest);
35
Java Methods
• A Java method consists of just one part, the method definition. The method definition is made up of the method header and the actual code to be executed.
• No function/method prototype or import statements are required; just the function/method definition (without ;) is required.
36
Java Method Syntax
Syntax:return-type functionName(data-type variable1, data-type
variable2, …)
Example 1:
//method definitiondouble calcInterest(int y, double p, double r){ double temp; temp = p * r * y; return temp;}
//method call in main()interest = calcInterest (years, principal, rate);
37
Another Java Method Example
Syntax:return-type functionName(data-type variable1, data-type
variable2, …)
Example2:
//method definitionvoid printLoanInfo(int y, double p, double r, double i){ System.out.println(“You will have to pay $” + i
+ “ interest on your loan of $” + p + “ for a term of ” + y + “ years at a rate of ”
+ r + “%.\n”;}
//method call in main()printLoanInfo(years, principal, rate, interest);
38
C# Methods
• A C# method consists of just one part, the method definition. The method definition is made up of the method header and the actual code to be executed.
• No function/method prototype or using statements are required; just the function/method definition (without ;) is required.
39
C# Function/Method Syntax
Syntax:
private return-type functionName(data-type variable1, data-type variable2, …)
Example 1:
//method definition
private decimal calcInterest(int y, decimal p, decimal r)
{
decimal temp;
temp = p * r * y;
return temp;
}
//method call
interest = calcInterest(years, principal, rate);
40
C# Methods
• C# functions will generally have the keyword private as access modifier. – private indicates this function can only be used within
this class (form) – public indicates this function can be used within other
classes
41
Create a project to compute a checking account balance. Use radio buttons to choose the type of transaction (deposit, checking, or service charge). The user will enter the amount of transaction in a text box. Display the new balance in a label. Include validation that displays a message box if the amount of transaction is 0 or less. If there is not enough money to cover a check, display a message box with “Insufficient Funds”. Do not pay the check, but deduct a service charge of $10.
Let’s Do a Problem Together
Write methods for processing deposits, checks, and service charges. The deposit method adds the deposit to the balance; the check method subtracts the check amount from the balance; the service charge method subtracts $10 from the balance.
The Summary menu item displays the total number of deposits, the dollar amount of the deposits, the total number of checks, and the dollar amount of the checks in a message box. The Clear menu item clears the radio buttons and the amount and resets the focus. The Color and Font menu items change the color and the font of the information displayed in the balance label. Use a message box to display the program name and your name for the About menu item.