Sei sulla pagina 1di 31

Visual Basic for Excel 97/2000 Practical workbook

Aims and Learning Objectives


By the end of these notes, you will know the basics of programming using Visual Basic for Excel. You will also be able to: Record macros Write small subroutines and functions to automate some of the processes in your spreadsheets Use those functions within workbooks Use Excel workbook functions within Visual Basic Procedures Display message boxes and obtain input from the user Begin to apply error trapping to your procedures

University of Bristol Information Services document exlvba-t1

Document Information Format conventions


The following format conventions are used in this document: Computer input that you type is shown in a bold Courier font Computer output, menu names and options, buttons, URLs are shown in a Courier font Text that you must replace is shown in italics Computer keys that you must press are in a bold Courier font and enclosed in angle brackets Further explanatory notes to the practical tasks are displayed in a shaded area. http://www.bristol.ac.uk/ Save, Go to, Refresh Enter your username <Enter>, <n>, <N>, </> Example text like this

Keyboard shortcuts
The following keyboard shortcuts may be of use whilst using these notes: <Alt><F11> <F1> To open the Visual Basic Editor (VBE) or switch between the VBE and your workbook. Use within the VBE window to obtain help on VB functions, objects and properties. Click within the word you require help with (do not select the word) and press <F1>. Toggle breakpoints position your cursor on a macro statement within the Visual Basic editor and press <F9> to set a breakpoint. When the macro is run, processing is suspended at the breakpoint(s) to allow you to inspect variable values and see what is going on. To clear all breakpoints. Use within the VBE window to display the Object Browser window.

<F9>

<Ctrl><Shift><F9> <F2>

Related documentation
The following local documents are available from the Web: Further Excel 2000 (document exl00-t3) VB Excel 97/2000: Creating custom dialog boxes (document exlvba-t2) Other books are available: Writing Excel Macros, Steven Roman, (Excel 97 and 2000) O'Reilly http://www.oreilly.com/ Excel 97 Programming for Windows for Dummies, John Walkenbach Excel 2000 Programming for Dummies, John Walkenbach Excel 2002 Power Programming with VBA, John Walkenbach (Wiley and sons) Visual Basic for Excel 97/2000 (03.04) http://www.bristol.ac.uk/is/selfhelp/documentation/ exlvba-t1/exlvba-t1.doc If you have any comments or queries about this document mail iser-docs@bristol.ac.uk. This document may be used wholly or in part by the academic community, providing suitable acknowledgment is made. It may not be used for any commercial or profit-making purpose without permission. 2004 University of Bristol. All rights reserved.

Contents
Format conventions Keyboard shortcuts Related documentation Task 1 Virus protection ................................................................................ 1 Task 2 Recording a macro............................................................................ 2 Task 3 Relative reference macros ................................................................ 3 Task 4 Editing a recorded macro................................................................. 5 Task 5 Simple loop structures ...................................................................... 6 Task 6 Debugging a macro ........................................................................... 7 Task 7 Using a Range variable..................................................................... 8 Task 8 Creating a function ........................................................................... 9 Task 9 Rearrange macro ............................................................................ 10 Task 10 Yes/No inputs................................................................................... 12 Task 11 Error trapping and GoTo .............................................................. 13 Task 12 MsgBox: Text & numerical values ................................................ 14 Task 13 Applying formats using macros..................................................... 15 Task 14 Text functions.................................................................................. 17 Task 15 Worksheet functions in VB ............................................................ 19 Task 16 InputBox .......................................................................................... 20 Appendix A Appendix B Appendix C Visual Basic objects....................................................................... A-1 Declaration of variables................................................................ B-1 Programming structures .............................................................. C-1

Introduction
Excel is the University's recommended spreadsheet product for Windows on PCs. This document is intended for the more experienced user of Excel who wishes to make use of Visual Basic for Applications (VBA). This document does not intend to teach VBA or even the concepts of object-oriented programming. Instead the examples in this document have been devised to show various aspects of Visual Basic for Excel. John Walkenbach's book in the "...for Dummies" series (see Related Information) gives a good explanation of these. When attending courses in the training rooms in the Computer Centre the working files and solutions referred to in this document are located in the directory C:\User\Excel\. If you are working on your own system, you need to download the file: http://www.bristol.ac.uk/is/selfhelp/documentation/exlvba-t1/exlvba-t1.exe, copy it to a folder on your hard disk and run it before starting these notes. In many cases there is continuation from one example to the next. If you wish to skip a particular exercise you will need to load the solution file to the previous example. When working through the examples you may also like to try modifying them in order to make them applicable to your own uses of Excel.

Prerequisites
It is essential that you have grasped the concepts of names and conditional functions, covered in Further Excel 2000 (document exl00-t3). Some experience of structured programming will be an advantage.

Acronyms
VB VBA VBE Visual Basic Visual Basic for Applications Visual Basic Editor

Visual Basic for Excel 97/2000

Task 1 Virus protection


Objectives Method Comments
To enable/disable Excels macro virus protection. You will use commands available on the Tools menu, dependant on the version of Excel. There are many problems with viruses that attach malicious executable files to applications. These are macros that are designed to cause damage and are built using all the flexibility and power that a Visual Basic Application offers the genuine programmer. Excel 97 and later versions have options to warn you if a spreadsheet or workbook that you are about to open contains macros. The solution files used for this practical document and the files you will create when working through these notes will contain macros that you will wish to run. You will therefore need to enable macros when opening them. However, it is not a habit you should get into - always consider each file on an individual basis and only enable macros if you believe them to be genuine. Incidentally, a poorly written macro could also cause unintended damage, so always check your own macros carefully before distributing them amongst colleagues/research groups. 1.1 Excel 97: From the Tools menu select Options. Select the General tab and ensure that Macro virus protection is selected. Click on OK. 1.2 Excel 2000: From the Tools menu, select Macro / Security. Using the Security Level tab, read the available options and select Medium. Click on OK. Note With this option enabled you are prompted to take action if a spreadsheet contains macros. You can choose to open the workbook with the macros enabled, disabled or to not open the workbook at all. If you disable the macros, you will be unable to run any macros or recalculate custom functions. You can still examine and edit the macros. When you click Save on the File menu, the macros are saved. You can then close the workbook and open it again with macros enabled if you want to run the macros. Enabling the Macro virus protection only offers a warning to the existence of a macro. It does not scan the workbook for known prank macros. Additional virus protection software is available for this purpose. If you wish to know more about viruses and the virus protection available within the University, please see the online information available from http://www.bristol.ac.uk/is/services/computers/virus/.

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

Task 2 Recording a macro


Objectives Method Comments
To record a simple macro to perform a repetitive task automatically. You will use the Record New Macro command to create a macro that you will use to insert a formatted heading in new workbooks. Although using macros may seem difficult at first, recording and playing back macros in Excel is really very easy. Using a new (blank) workbook, select cell A1. From the Tools menu, click on Macro and Record New Macro. In the Macro Name box enter the macro name Company_name. Assign a Shortcut key by selecting the Ctrl+ box and pressing <n>. Under Store macro in, select This Workbook. Edit Description as required and click on OK. 2.4 Select cell A1 and type The University of Bristol Select A1 and format it as Times New Roman, size 24, Bold and Italic. 2.5 Note Stop recording the macro (click on the Stop icon toolbar). on the Stop Recording

2.1 2.2 2.3

If the Stop Recording toolbar is not available, you could display it using the View/Toolbars/Stop Recording. However, this would then be inserted into your macro and the toolbar displayed every time the macro is run. Use the alternative method instead: From the Tools menu, select Macro and Stop Recording. If you fail to stop recording the macro at this stage, you will create an infinite loop of record and playback.

2.6 Note 2.7

Select Sheet2 and cell A1. If you do not have a Sheet2; from the Insert menu, select Worksheet. From the Tools menu, select Macro and Macros. Select Company_name, click on Run and watch the result.

2.8

Select Sheet3 and click in cell A1. Run the macro again, this time by pressing <Ctrl><n>.

2.9

Insert a new Worksheet and click in a cell other than cell A1. Run the macro again and observe where the title heading and formatting are inserted.

2.10

Do not close the current workbook.

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

Task 3 Relative reference macros


Objectives Method
3.1 3.2 3.3 To record a simple macro to perform a repetitive task automatically, relative to the macros starting point. You will use the Relative reference toolbar command. Create a new (blank) workbook. Select A1. From the Tools menu, select Macro and Record New Macro. In the Macro Name box enter the macro name Months. Assign a shortcut key by selecting the Ctrl+ box and pressing <m>. Again, store the macro in This Workbook. Choose OK. 3.4 Note Click on the Relative reference icon (on the Stop Recording toolbar) to record your macro relative to its starting position. It is recommended that you select the Relative Reference option so that your macro turns out correctly no matter what cell you start in, relative to your starting position. If this option is not selected, Excel uses absolute cell references. This means that the macro always starts in the same cell reference as in the previous task. If the Stop Recording toolbar does not appear, first stop your macro from recording: -> From the Tools menu, select Macro, Stop Recording Add the Stop Recording toolbar to the list of available options: -> From the View menu, select Toolbars, Customize -> Select Stop Recording from the list of available toolbars and click on Close. You will now need to start recording your macro again from task 3.2. 3.5 Type January then copy (auto-fill) this across the row to cell L1, to get January:December. Change the format of the cells; for example, font, size, bold, etc. Format these cells so that they are vertically aligned (orientation 90 degrees). Select the columns A:L and AutoFit the column selection to make them best-fit. 3.6 3.7 Click in cell A2 and Stop recording the macro (as in task 2.5). Select Sheet2 and click in any cell other than A1. Run the macro (<Ctrl><m>) and watch the result. Do not close the workbook. Note These macros have been saved in the relevant workbooks. When the workbook is closed, any macros available within it will no longer be available to open workbooks. If you then want to create macros available for use in all your workbooks you will need to store them in the Personal Macro Workbook. To do this, select Personal Macro Workbook from the Store macro in the dropdown box of the Record Macro dialog box (in task 3.3).

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

If you want to make any changes to the macro (as in the next task) you will first need to unhide personal.xls. From the Window menu, select Unhide and with Personal.xls highlighted, click on OK. When you quit Excel you will be asked if you wish to save the changes made to the personal macro workbook. If you click on Yes, the file personal.xls is opened as a hidden workbook. Personal.xls is stored in the folder (for a default installation of Windows NT):
c:\winnt\profiles\username\Application Data\Microsoft\Excel\XLStart

Or (for a default installation of Windows 2000):


C:\Documents and Settings\username\Application Data\Microsoft\Excel\XLSTART

The personal.xls workbook is opened next time you start Excel and is not available to other users.

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

Task 4 Editing a recorded macro


Objectives Method Comments
To introduce the Visual Basic Editor (VBE). You will use the VBE to view the macro created in the previous task. Quite complicated macros can be written simply by recording tasks as you have done above. However, Excel converts these tasks to a programming language called Visual Basic. More advanced macros can written in this language. From the Tools menu, select Macro and Macros. Select Months and click on Edit. 4.2 The Microsoft VBE appears similar to figure 1. The left-hand pane shows the name of the current module and allows navigation between modules. The right-hand pane contains the contents of the current module you are working on. Your macro is listed in the module window as a subroutine (Sub). 4.3 Take a look at the programming used for your Months macro.

4.1

Figure 1 Visual Basic editor (months macro)

4.4

You may also like to look at the Company_name macro created in task 2 to see how the relative references make a difference. Using the left-hand pane, navigate to VBA Project (Book1)/Modules/Module1 (replacing Book1 with the name of your workbook). Return to the Months module and, if you wish, make a small change (such as the font size). Make sure that you modify the last occurrence of .Size= in the macro. In some cases, such as the simple macros recorded so far, it may be quicker to delete and re-record the macro than edit the code. From the File menu, select Close and Return to Microsoft Excel. If you made any changes to the code, run your macro again. Close any open workbooks, discarding changes. Later examples explain the program structures and language used. Appendix 1 introduces the concepts of Visual Basic objects. Lines that are just text comments and not Visual Basic commands are preceded with a single quotation mark. If you forget to assign a shortcut key (such as <Ctrl><m>) to a macro at the time of recording, you can assign one later by returning to the workbook and, from the Tools menu, selecting Macro/Macros and the Options button.

4.5

4.6 4.7 Note

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

Task 5 Simple loop structures


Objectives Method Comments
To write a macro to enter values into a workbook using a simple loop structure. You will use the VBE. This task uses a single, self-contained subroutine and there is no need to explicitly declare any variables used. See the note at the end of this task for a caution on using variables in this manner. Create a new (blank) workbook. From the Tools menu, select Macro / Visual Basic Editor (or press <Alt><F11>). From the Insert menu, select Module. A new (empty) module appears in the right-hand pane of the VBE (if Option Explicit is entered at the top of your module, highlight and delete it). This module will contain your Visual Basic code. 5.4 5.5 5.6 From the Insert menu, select Procedure. In the name box, type myloop and click on OK. In Excel spreadsheets we refer to cells by their column letters and row numbers (for example, A1). In a Visual Basic procedure we use cells(1,1) or cells(1,"A") to refer to cells, as demonstrated in the following example. Enter the code (in bold below): Public Sub myloop() Row = 1 For Number = 1 To 100 Cells(Row, "A") = Number Row = Row + 1 Next Number End Sub In this example the column used is fixed (A). The first number is entered in column A, row 1 and increased by 1 until all the numbers (up to 100) have been entered. 5.7 From the Run menu, select Run Sub/UserForm (or press <F5>). If you had more than one procedure (or form) you would be asked to select the one you wish to run. 5.8 Note Switch back to the worksheet to see the results (<Alt><F11>). Terminology - your recorded macro has been saved as a subroutine within a module in your workbook. Indentation is used in the program loop above. This makes it easier to follow the various structures within procedures. This example makes use of variables that we choose to call Row and Number. These variables contain temporary values that are changed as the macro is run. We have not specified what kind of values are to be stored in these variables. Visual Basic treats these as of type Variant and is very tolerant of the kind of information that can be stored in them. Sometimes this tolerance can lead to undesirable errors. See appendix 2 for information on how you can specify variables more precisely.
Visual Basic for Excel 97/2000 (exlvba-t1) 6

5.1 5.2 5.3

Visual Basic for Excel 97/2000

Task 6 Debugging a macro


Objectives Method Comments
To introduce the Visual Basic debugger. You will enter a mistake in the macro created in the previous task and use the debugging tools to correct your programming. Some mistakes in coding a program will cause Visual Basic to give an error message. Clicking on <Debug> will enter the VBE, highlighting the error. Using the macro created in the previous task, switch to the VBE (press <Alt><F11>). Alter the line Cells(Row, "A") = Number to: Cells(Roww, "A") = Number 6.3 Re-run the macro; a runtime error message dialog box is displayed. Click on Debug. You should now be in the Visual Basic run-time debug mode with the line causing the problem highlighted. 6.4

6.1 6.2

Figure 2 - run-time error message box

Position the mouse cursor over a variable, for example Number. Note that the current value for the variable is displayed. Position the cursor over the misspelt variable, Roww. The text Roww = Empty is displayed. Correct the mistake (remove the extra w). From the Visual Basic Run menu, select either: Continue to resume processing the macro, OR: Reset and then switch to the worksheet before re-running the macro.

6.5 6.6 6.7

Note

When editing a Visual Basic macro you can position the cursor on a macro statement and set (or unset) breakpoints (from the Debug menu, select Toggle Breakpoint or press <F9>). When the macro is next run, execution will stop before the statement and enter into the debug mode. You can then inspect variables and see what is going on. To restart the macro, from the Run menu, select Continue. To clear all breakpoints, from the Debug menu, select Clear All breakpoints (or press <Ctrl><Shift><F9>).

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

Task 7 Using a Range variable


Objectives Method Comments
7.1 7.2 To format a particular range of cells in a chosen way. You will use the VBE to create a macro. You will use the macro, myloop, created in task 5. Switch to the VBE. Insert the following lines (in bold) immediately above the End Sub statement: Range(A1:A100).Select With Selection.Font .Name = Arial .Size = 14 End With Note We can refer to ranges of cells as Range("A1:J10") or even Range(Cells(1,1), Cells(10, 10)). The latter format allows us to replace actual numbers with variables. Cells can have their format attributes set directly. For example, Range(A1:A100).Font.Name = Arial Quite often it is convenient to use the With End With language construct so that the attributes of a range of cells can be set without repeating the range specification each time. 7.3 7.4 Switch to the spreadsheet, delete the contents and run the myloop macro. Note the effect of the formatting on the cells. Close your workbook. There is no need to save it.

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

Task 8 Creating a function


Objectives Method Comments
To demonstrate how user-defined functions can be easily created and used. You will use the Insert menu commands in the VBE. Excel has a large number of functions available, but there are times when it is necessary to create a user-defined function to perform a particular calculation. These functions cannot be created using the macro record and playback actions within Excel, but must be entered into the VBE. Create a new workbook. Open the VBE (use <Alt><F11> as a shortcut). From the Insert menu, select Module. From the Insert menu, select Procedure. In the Add Procedure dialog box, enter the name times100 and from the Type section, select Function (Public should already be selected from the Scope section). Click on OK. Note A user-defined function is used in the same way as an Excel function. It has a name (in this case, times100) and a number of arguments (in some cases, zero). We will define a function that takes one numeric argument, multiplies it by 100 and returns the result. Place the cursor between the brackets on the first line. Enter a variable name for the argument; for example, n Move the cursor to the empty line of the function and enter the command times100 = n * 100 Your function should be similar to the one below: Public Function times100(n) times100 = n * 100 End Function 8.8 8.9 Note 8.10 8.11 Switch to the worksheet, select cell A1 and enter a value. In cell B1, enter the function =times100(A1) Functions and subroutines created in VBA are not case-sensitive. Try changing the value in cell A1 and note the result. Close and Save this workbook; you will need the function in a later task.

8.1 8.2 8.3 8.4

8.5 8.6 8.7

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

Task 9 Rearrange macro


Objectives Method Comments
To create an application to rearrange student marks for processing. You will use Excels VBE to write a short VB program. Try typing the subroutine in lower case and notice how the editor formats your commands. This task assumes a working knowledge of cell and range names (covered in document exl00-t3). 9.1 Open the file Exam1.xls (in Computer Centre training rooms, this is in the folder C:\User\Excel). The worksheet contains some subject results for fictional students (figure 3).

Figure 3 - Exam1.xls (fictional table of results)

This task will rotate those results (figure 4) in order to make use of other features within Excel such as Subtotals and PivotTables. 9.2 Highlight the range A1:G13 and define a range name, area.
Figure 4 - sample of rotated data

Click in cell I1 and define a name, areaoutstart. 9.3 Switch to the VBE and insert a new module. Insert a new procedure (subroutine) named rearrange.

Visual Basic for Excel 97/2000 (exlvba-t1)

10

Visual Basic for Excel 97/2000

9.4 Note

Enter the following code (in bold): The following text is available in the working folder as task9_4.txt to copy and paste if you prefer not to type it. Take a few moments reading through the code to get an idea of the structure and what might be happening. Public Sub rearrange() Set ar = Range("area") Set arout = Range("areaoutstart") ncols = ar.Columns.Count nrows = ar.Rows.Count aroutr = 2 countblankcells = 0 arout.Cells(1, 1) = "Name" arout.Cells(1, 2) = "Subject" arout.Cells(1, 3) = "Mark" For r = 2 To nrows For c = 2 To ncols If Not IsEmpty(ar.Cells(r, c)) Then arout.Cells(aroutr, 1) = ar.Cells(r, 1) arout.Cells(aroutr, 2) = ar.Cells(1, c) arout.Cells(aroutr, 3) = ar.Cells(r, c) aroutr = aroutr + 1 Else countblankcells = countblankcells + 1 End If Next c Next r End Sub

Note

The variable countblankcells is used to calculate the number of blank cells encountered when running the macro. The total number will be displayed at the end of the macro (see task 12). The variables ar and arout are ranges and must be initialised using the Set command. By qualifying Cells with a range variable, for example, ar.cells(1,1) we now reference cells within that range rather than the cells within the whole worksheet. The solution example, vbexam_a.xls, contains comments to explain the use of these variables and functions.

9.5 9.6 9.7

Switch back to the worksheet (click on the icon in the Status bar or use <Alt><F11>). Save your workbook. From the Tools menu, select Macro/Macros and with the rearrange macro selected, click on Run.

Visual Basic for Excel 97/2000 (exlvba-t1)

11

Visual Basic for Excel 97/2000

Task 10 Yes/No inputs


Objectives Method Comments
To display a message box requesting input from the user of the macro and use that input to determine what actions your macro will take. You will use the Msgbox function. If you have not successfully completed the previous task, you will need to open the solution file vbexam_a.xls before starting. Switch to the VBE. At the top of your macro module (immediately below the line Public Sub rearrange()), insert a new line and add the line macroname = rearrange This name will be used for message display in the dialog boxes created below. 10.3 Insert a new row between nrows = ar.Rows.count and aroutr = 2. Type the following code (shown in bold) : nrows = ar.Rows.Count arout.Range(Cells(1, 1), Cells(1, 3)).Select
Msg = "This macro may overwrite cells starting at range shown."

10.1 10.2

Reply = MsgBox(Msg & vbCr & _ "Do you want to continue?", vbYesNo, macroname) If Reply <> vbYes Then MsgBox "Macro abandoned", vbOKOnly, macroname Exit Sub ' quit the macro End If aroutr = 2 Note As you type functions, for example MsgBox, you will notice that the editor displays the parameters required by that function. Appropriate drop down boxes also provide shortcuts as you type your procedures. The ampersand character & is used to string together text strings and text variables whilst the underscore character _ allows you to continue a single line command on the following line for display purposes. Blank spaces are ignored. Indentation in an application is used to make the program easier to read and debug. The standard constant vbCr is used to insert a carriage return into your dialog box. The standard constant vbYes is returned if the Yes button is clicked in reply to the message. The operator <> is used to denote not equal to. 10.4 10.5 Switch back to the worksheet and save your workbook. Highlight and delete the results of the previous task and from the Tools menu, select Macro/Macros and with the rearrange macro selected, click on Run. Test your macro using both No and Yes inputs to your dialog box. 10.6 Take a few moments to read the comments (preceded by a single apostrophe) in the solution file vbexam_b.xls.
12

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

Task 11 Error trapping and GoTo


Objectives Method Comments
To introduce some error trapping. You will introduce an On Error GoTo structure to display an error message of your choosing and exit the subroutine. The rearrange macro created in the previous tasks requires that two range areas be defined before the macro is run. If these ranges are not defined, Excel will generate an error and the macro will fail. By checking for this error, you can display a sensible message and exit the macro cleanly. Using the macro created in the previous task switch to the VBE. If you have not successfully completed the previous task, you will need to open the solution file, vbexam_b.xls, before starting. 11.2 Immediately beneath the line macroname = rearrange, insert and new line and type: On Error GoTo errmsg If the ranges area and areaoutstart have not been defined in your spreadsheet, the macro will jump to a point labelled errmsg (defined below in task 11.4). 11.3 Beneath the lines set ar and set arout add the command On Error GoTo 0. This section of code should now resemble: On Error GoTo errmsg Set ar = Range("area") Set arout = Range("areaoutstart") On Error GoTo 0 Any errors encountered from this point on in your macro will display the normal system errors rather than the one you specify in the errmsg section. 11.4 Scroll to the end of the macro and add an errmsg section immediately above the last (End Sub) line: errmsg: MsgBox "Bad input/output range.", vbOKOnly End Sub 11.5 11.6 11.7 Immediately above the errmsg: line, add a new line Exit Sub to ensure that this error message is only reached from the GoTo command entered in task 11.2. Switch to the spreadsheet and save your workbook. Delete your previous output and check that the macro runs without error. Try deleting one or both of the range names (from the Insert menu, select Name / Define) and test the macro again. Note You may also wish to check that the selected input range ar is sufficiently big and that the output range areaoutstart is not within the input range, area. Your macro should then exit after displaying a dialog box. Open and examine the example spreadsheet vbexam_c.xls for a suggested solution to this additional checking. 11.8 Close and reopen your workbook without saving any changes.
13

11.1

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

Task 12 MsgBox: Text & numerical values


Objectives Method Comments
To calculate the number of lines output by the rearrange macro and output the result in a dialog box together with the total number of blank cells encountered (if any). You will use the Str function. The variables aroutr and countblankcells introduced in task 9 contain the values required for this exercise. If you have not completed the previous tasks, first open vbexam_c.xls. Switch to the VBE and scroll to the foot of your macro. Between the lines Next r and Exit Sub, add the following code: If aroutr > 1 Then arout.Cells(aroutr - 1, 3).Select MsgBox "This macro has output " & _ Str(aroutr - 2) & " lines." & vbCr & _ "It found " & Str(countblankcells) & _ " blank cells.", vbOKOnly, macroname Else MsgBox "No lines output!", vbYesNo, macroname End If 12.4 12.5 Note 12.6 From the File menu (still within the VBE), select Close and Return to Microsoft Excel. Save your workbook and test the macro. Vbexam_d.xls contains a working solution to this exercise. Close any open workbooks. There is no need to save changes.

12.1 12.2 12.3

Visual Basic for Excel 97/2000 (exlvba-t1)

14

Visual Basic for Excel 97/2000

Task 13 Applying formats using macros


Objectives
To produce a small Visual Basic Application (VBA) that checks the current formatting of cells within a worksheet and removes the percentage sign if a particular format has been used. You will use the Cells.NumberFormat object and IsNumeric and IsBlank Visual Basic functions. This task assumes that you have successfully completed task 8. Open the file created in task 8 (Creating a function) and press <Alt><F11> to switch to the VBE. Insert a new Procedure, named RemoveSign (type = Sub, Scope = Public). 13.2 We first need to select the last cell in use within the active worksheet. Enter the following code into your procedure: ActiveSheet.Cells.SpecialCells(xlLastCell).Select ir = ActiveCell.Row ic = ActiveCell.Column For row = 1 To ir For column = 1 To ic If IsNumeric(Cells(row, column)) And Not _ IsEmpty(Cells(row, column)) Then in_no = Cells(row, column) If Cells(row, column).NumberFormat = "0.00%" Then Cells(row, column) = times100(in_no) Cells(row, column).NumberFormat = "General" End If End If Next column Next row Note Working through this code from top to bottom: The last cell in the worksheet is located and the variables ir and ic are set to the row and column position values of that cell. The For Row and For Column structures ensure that the procedure loops through each row and column used in the worksheet. The first If End If structure checks to see if the current cell is not empty and that its value is numerical. If these conditions are not met, the procedure moves to the next column/row. If the conditions are met, the variable in_no is set to the value of the current cell and the next IfEnd If statement looks to see if the current value is formatted as a percentage with 2 decimal places. If it is, the value is multiplied by 100 (using the function created in task 8) and a general format applied. 13.3 Switch to the worksheet view, save your file and enter some values in your worksheet (ensuring you have one or more numeric values formatted as percentages with 2 decimal places).
15

Method Comments
13.1

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

13.4 13.5

Test your VBA (vbformat.xls contains a working solution with some sample values to test it on). The second IfEnd If statement in the above code could be extended to deal with Percentage formats with different numbers of decimal places (see the commented out section of vbformat.xls). Close any open workbooks.

13.6

Visual Basic for Excel 97/2000 (exlvba-t1)

16

Visual Basic for Excel 97/2000

Task 14 Text functions


Objectives Method Comments
To create a function to reverse text strings and use this function to extract a surname from a text string containing a full name. You will use a combination of worksheet functions and your own function. The application assumes that the surname is the last word in a string. You may wish to extend this task to take into consideration surnames such as in Daphne du Maurier or van der . Start a new workbook. In cell A1, enter the text Name. Enter the names Mr A B Brown, Pat Smith, Dr White and A B C Evergreen in cells A2, A3, A4, A5 respectively. Resize column A to fit the text entered. 14.3 14.4 14.5 In cell E1, enter the text Surname. Open the VBE. Create the function rev as below: Public Function rev(t) rev = "" ct = Len(t) For i = ct To 1 Step 1 rev = rev & Mid(t, i, 1) Next i End Function Note StrReverse was introduced as an Excel Visual Basic function with the release of Excel 2000. If you are using Excel 2000, try the simpler method below: Public Function rev(t) rev = StrReverse(t) End Function 14.6 Return to the worksheet and select B2. Enter the formula =rev(A2) to calculate the reverse of the string in cell A2. Resize column B if necessary. 14.7 In cell C2, enter the formula =FIND(" ",B2) to find the location of the first space character in the text string in cell B2. As B2 now contains the reverse of the original text string, this locates the location of the last space character in the original string. 14.8 In cell D2, enter the formula =LEFT(B2,C2-1) This takes the left hand side of the reversed string up to, but not including, the space character. In other words, the surname part of the original text string reversed. Note 14.9 If there are no spaces in the original name, then the formula in column C will produce an error. In this case additional steps can be taken to deal with this scenario. In cell E2, enter the formula =rev(D2) to reverse the string and return the surname as required.
17

14.1 14.2

Visual Basic for Excel 97/2000 (exlvba-t1)

Visual Basic for Excel 97/2000

14.10 14.11 Note

Copy the formulae in the range B2:E2 into rows 3 to 5. Select columns B:D and from the Format menu, select Column/Hide. See vbreverse_a.xls for a working solution. This function could be extended to include the actions performed by columns B to E. The next task demonstrates this.

Visual Basic for Excel 97/2000 (exlvba-t1)

18

Visual Basic for Excel 97/2000

Task 15 Worksheet functions in VB


Objectives Method Comments
To extract the surname from a text string containing a name. You will use the VBE. This task reuses the text entered in the previous task but not the function rev nor the formulae. If you completed the previous task, unhide columns B:D and delete the formulae in the range B2:E5. Otherwise enter the text as described in tasks 14.1 to 14.3 above. 15.2 15.3 Switch to the VBE. Create the following VB function: Function getSurname(t) backText = rev(t) spaceLoc = Application.WorksheetFunction. _ Find(" ", backText) backSurname = Left(backText, spaceLoc - 1) getSurname = rev(backSurname) End Function 15.4 Switch to the worksheet and click in cell B2. Enter the formula =getSurname(A2) 15.5 Note Copy (drag & fill) this formula into the range B3:B5. The file vbreverse_a.xls contains a working solution. Application.WorksheetFunction can be used before any Excel Worksheet function, provided there is not also a Visual Basic function with the same name. As you type your code, type Application.WorksheetFunction. and examine the list of options displayed in the dropdown box. There is a Visual Basic function called InStr that does the same job as the Excel Find function and would be more efficient to use. This task simply demonstrates the use of an Excel worksheet function within a Visual Basic macro.

15.1

Visual Basic for Excel 97/2000 (exlvba-t1)

19

Visual Basic for Excel 97/2000

Task 16 InputBox
Objectives Method Comments
16.1 16.2 16.3 16.4 To obtain and use input from the user. You will use the InputBox function in Visual Basic. You must first have successfully completed task 15. With the worksheet created in task 15 open, switch to the VBE. From the Insert menu, select Procedure. Type the name Surname and click on OK. Complete the procedure as shown in bold: Public Sub Surname() myString = InputBox("What is the full name?") Msg = "The surname is " MsgBox Msg & getSurname(myString), vbOKOnly End Sub 16.5 16.6 Note Run the procedure (press <F5> or from the Visual Basic Run menu, select Run Sub/UserForm). When prompted enter the name Dr P A Brown and click on OK. See vbreverse_b.xls for a working solution together with additional code for allowing the user to select the Cancel button (or press the <Esc> key). The solution also deals with blank and numeric values entered into the dialog box.

Visual Basic for Excel 97/2000 (exlvba-t1)

20

Visual Basic for Excel 97/2000

Appendix A
Comments

Visual Basic objects

Some of the items referred to in the examples are more complicated than simple numeric constants and values. Such variables are called objects. For instance the variables that refer to Excel ranges, worksheets, charts, and workbooks are objects. This appendix gives a very rough explanation of how to find out what objects there are and how they interact.

Libraries
Objects are grouped in classes (for example, Excel, Office) and their definitions stored in specific libraries. Visual Basic for Excel starts with a default set of libraries. Libraries can easily be added to the set (from the VBE Tools menu, select References). A reference to an object that is not in the current set of object definitions will cause an error.

Properties and methods


Each object is defined by having a particular set of properties and methods. The period character is used as a separator when referring to the properties and methods of objects. For instance the Range object has a property called Cells that can be used to refer to a particular subset of the range.

Example Range(A2..Z11).Cells(1,1) refers to cell A2 in the currently active


worksheet. The object created by the use of the Cells property is itself a Range object. So the Font property of a Range object can be used to generate a Font object. The Size property of the Font object can then be used to set the size of the font.

Example Range(A14..Z14).Cells(2,1).Font.Size=12 will set the font size of


cell A15 to 12 points. A Range object has a Clear method that will clear all the cells in the range.

Example Range(A1).Clear will clear the contents and formatting of cell A1.
Methods cause acts to be done to the object, while Properties return simple values and objects that are associated with the object As can be seen from these examples, each property and method has its own set of rules defining what arguments are necessary to construct a valid reference to it. If present the arguments are enclosed in parenthesis and separated by commas. Any text constant argument must be enclosed in double quotes. There is an alternative form of specifying arguments using keywords that is useful when there are many arguments.

Example Workbooks.Open Filename:="C:\Sales.xls", ReadOnly:=True Collection objects


There are many objects that are used to control collections of objects of the same type. For instance the Workbooks object can be used to control all the Workbook objects. It can be used to create a Workbook, provide the names of all the Workbook objects, a count of the Workbook objects, etc.

In general the collection objects will share many methods and properties, for example, Count, Add, Item, Close.
Visual Basic for Excel 97/2000 (exlvba-t1) A-1

Visual Basic for Excel 97/2000

Finding information about objects


If you already know the name of an object and require further help (or you merely want to browse), then the Object browser tool can be used: From the VBE View menu, select Object browser (or press <F2>). From the Project/Library dropdown box, select Excel (default <All Libraries>). Under classes, select a class, (Range in figure 5). Right-click the mouse and select Help.
Figure 5 - object browser window (<F2>)

A separate help window will be created (if it does not already exist) containing information about the chosen item. Quite often there will be Properties and Methods buttons that can be clicked to get information about all the properties and methods for the chosen object. Because it is sometimes difficult to guess whether a particular item is a property or a method, it is often necessary to look in both lists to find its definition. When it is available on the help window, the Example button can be clicked to give useful information and the displayed example text pasted into your program to be edited for your own use.

Excel object model


To display the hierarchy of Excel objects graphically: Start the VBE (<Alt><F11>). From the Help menu, select Microsoft Visual Basic Help. If the Office Assistant appears you will need to disable it: Right-click on the assistant and select Options. Remove the tick from Use the Office Assistant and click on OK. Select Help / Microsoft Visual Basic Help again. Select the Answer Wizard tab. Using the What would you like to do box, type Microsoft Excel Objects and click on Search. Under Select topic to display, click on Microsoft Excel Objects.

Referring to worksheets and workbooks


In general, all objects that refer to specific Excel items (such as ranges and charts) are properties and methods of the Application object. There is a special subclass of objects called the global subset, which is a set of those objects that can be used without putting the suffix Application. before them.
Visual Basic for Excel 97/2000 (exlvba-t1) A-2

Visual Basic for Excel 97/2000

ActiveWorkbook and ActiveSheet are such global objects. They refer to the currently active workbook and worksheet respectively. If a Range object is used, which is not specifically associated with a particular sheet or book, then it is assumed to refer to the ActiveWorkbook.ActiveSheet object. If only one Excel workbook is open, then this will be defined to be the ActiveWorkbook. The sheet selected when the macro is run will be the ActiveSheet. If all the objects you want to access are in this sheet then there is no need to associate them with a parent object. If you want to access objects in other sheets or workbooks, then objects such as Sheets and Workbooks need to be used.

Example Workbooks(exone.xls).Sheets(Sheet1).Range(A1) refers to


cell A1 in Sheet1 of the workbook exone.xls. Note Workbooks are only differentiated by their filename (including their suffix but not including their folder name). Names of sheets, folders and files are not case-dependent. If the workbook is not already open then the macro will have to open it using the Workbooks Open method:

Example Workbooks.Open ("C:\Ex\Large.xls")


A particular workbook may be made the active workbook via:

Example Workbook(exone.xls).Activate
A particular sheet may be made the active sheet via:

Example Sheets(Sheet2).Activate Warning Before the ActiveCell object can be used or a particular range selected using the
Select method, then an ActiveSheet object must have been defined.

Declaring and assigning values to object variables


When making repeated references to the same complex object it is more efficient to use variables to hold the objects and refer to these instead (see also Appendix 2). It also gives better code readability. Object variables can be declared just like simple variables using the Dim statement.

Example Dim Rngx As Range


To assign values to object variables, the Set statement must be used rather than the simple equals assignment statement:

Example Set Rngx = Range(A1..Z26)


Rngx.Font.Size = 16 Note: object variables point to the object rather than are the object. It is good practice to free such variables when they are no longer required. To do this set them to the special Nothing keyword.

Example Set Rngx = Nothing


Many objects have a default property or method that is used when the object has not been fully specified. For a Range variable this property is normally the Value property.
Visual Basic for Excel 97/2000 (exlvba-t1) A-3

Visual Basic for Excel 97/2000

Example The statement Range(A1)=Range(B1) will be treated as


Range(A1).Value = Range(B1).Value

Visual Basic for Excel 97/2000 (exlvba-t1)

A-4

Visual Basic for Excel 97/2000

Appendix B
Comments

Declaration of variables

The examples in these notes introduce variables as they are needed within the subroutines. However it is good practice to declare your variables before you use them in a procedure (subroutine or function). By assigning the data type to each variable the program will run faster and use memory more efficiently. If a variable is not explicitly declared, it is of type variant. In general, Visual Basic is very tolerant of the kind of information that can be stored as type variant. A variable can be declared in 3 places:

Single procedure only If a variable is to be used within a single procedure only, declare it with a Dim or Static statement in the procedure that uses that variable. A static variable is one that retains its value even when the procedure ends.

Example Sub MySub()


Dim i As Integer,j As Integer Dim ar As Excel.Range Dim Surname As String Static Count As Integer [Write the VB code here] End Sub

Module only If a variable is to be used throughout the procedures within a module, use a Dim statement before the first Sub or Function statement in that module.

Example Dim First As String


Dim InterestRate As Single Sub FirstSub() [Write the VB code here] End Sub [More functions/subs here] All procedures in all modules If a variable is required in more than one module, declare it using a Public statement before the first Sub or Function statement in a module.

Example Public VatRate as Long = 0.175


Function FirstFunction(i, j) [Write the VB code here] End Function [More functions/subs here]

Visual Basic for Excel 97/2000 (exlvba-t1)

B-1

Visual Basic for Excel 97/2000

In the examples within this document, only a few procedures are used. However, as a large program is developed using multiple procedures across several modules, it becomes essential to declare all variables used. Efficiency aside, spelling mistakes can occur within variable names leading to incorrect calculations. Use the statement Option Explicit as the first line within a module to force the declaration of variables. The program will stop if a variable name has not been declared. Note The VBE can be configured to automatically insert the Option Explicit line in new modules. From the Tools menu, select Options. Within the Editor tab, select Require Variable Declaration. The declaration Dim i, j As Integer will declare j as an integer and i as a variant. See the online help for more information on declaring variables and variable types.

Visual Basic for Excel 97/2000 (exlvba-t1)

B-2

Visual Basic for Excel 97/2000

Appendix C

Programming structures

Comments This appendix includes examples of some of the programming structures available to
you when writing VBA code. For further information on their use, please see the online help system. Where square brackets [] are used, this indicates that this part of the structure is optional. For Next For expression (item=) {do these commands} Next item

Do Loop Until Do {do these commands} Loop Until expression

If then If condition Then {do this single command} [Else] Alternatively, using the block syntax: If condition Then {do these commands} Else {do these alternative commands} End If

For Each Next For Each Cht in Sheets(Sheet1).ChartObjects (or Cell in Selection) Cht.Chart.ChartType = xlLine Next Cht

Select Case End Select Select Case Quantity Case 0 To 24: Discount = 0.1 Case 25 To 49: Discount = 0.15 Case 50 To 74: Discount = 0.2 Case Is >= 75: Discount = 0.25 End Select

Visual Basic for Excel 97/2000 (exlvba-t1)

C-1

Potrebbero piacerti anche