MATLAB® the Language of Technical Computing
Total Page:16
File Type:pdf, Size:1020Kb
MATLAB® The Language of Technical Computing Creating Graphical User Interfaces Version 7 How to Contact The MathWorks: www.mathworks.com Web comp.soft-sys.matlab Newsgroup [email protected] Technical support [email protected] Product enhancement suggestions [email protected] Bug reports [email protected] Documentation error reports [email protected] Order status, license renewals, passcodes [email protected] Sales, pricing, and general information 508-647-7000 Phone 508-647-7001 Fax The MathWorks, Inc. Mail 3 Apple Hill Drive Natick, MA 01760-2098 For contact information about worldwide offices, see the MathWorks Web site. MATLAB Creating Graphical User Interfaces © COPYRIGHT 2000 - 2004 by The MathWorks, Inc. The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. No part of this manual may be photocopied or repro- duced in any form without prior written consent from The MathWorks, Inc. FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentation by, for, or through the federal government of the United States. By accepting delivery of the Program or Documentation, the government hereby agrees that this software or documentation qualifies as commercial computer software or commercial computer software documentation as such terms are used or defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms and conditions of this Agreement and only those rights specified in this Agreement, shall pertain to and govern the use, modification, reproduction, release, performance, display, and disclosure of the Program and Documentation by the federal government (or other entity acquiring for or through the federal government) and shall supersede any conflicting contractual terms or conditions. If this License fails to meet the government's needs or is inconsistent in any respect with federal procurement law, the government agrees to return the Program and Documentation, unused, to The MathWorks, Inc. MATLAB, Simulink, Stateflow, Handle Graphics, and Real-Time Workshop are registered trademarks, and TargetBox is a trademark of The MathWorks, Inc. Other product or brand names are trademarks or registered trademarks of their respective holders. Printing History: November 2000 Online only New for MATLAB 6.0 (Release12) June 2001 Online only Revised for MATLAB 6.1 (Release 12.1) July 2002 Online only Revised for MATLAB 6.5 (Release 13) June 2004 Online only Revised for MATLAB 7.0 (Release 14) October 2004 Online only Revised for MATLAB 7.0.1 (Release 14SP1) Contents Getting Started with GUIDE 1 What Is GUIDE? . 1-2 Starting GUIDE . 1-3 The Layout Editor . 1-4 GUIDE Templates . 1-6 Running a GUI . 1-8 GUI FIG-Files and M-Files . 1-9 Programming the GUI M-file . 1-10 Editing Version 5 GUIs with Version 7 GUIDE . 1-12 Saving the GUI in Version 7 GUIDE . 1-12 Updating Callbacks . 1-13 Creating a GUI 2 Designing the GUI . 2-2 Laying Out the GUI . 2-3 View Layout and Code for the Example . 2-3 Open a New GUI in the Layout Editor . 2-4 Set the GUI Figure Size . 2-6 Add the Components . 2-7 Align the Components . 2-9 i Setting Properties for GUI Components . 2-11 Name Property . 2-11 Title Property . 2-12 String Property for Push Buttons and Static Text . 2-12 String Property for Pop-up Menus . 2-12 Callback Properties . 2-14 The Tag Property . 2-14 Programming the GUI . 2-17 Creating the GUI M-File . 2-17 Opening the GUI M-File . 2-17 Sharing Data Between Callbacks . 2-19 Adding Code to the Opening Function . 2-20 Adding Code to the Callbacks . 2-22 Using the Object Browser to Identify Callbacks . 2-24 Saving and Running a GUI . 2-26 Laying Out GUIs and Setting Properties 3 Using GUIDE Templates . 3-2 Blank GUI . 3-3 GUI with Uicontrols . 3-4 GUI with Axes and Menu . 3-5 Modal Question Dialog . 3-6 Using the Layout Editor . 3-9 Starting the Layout Editor . 3-9 Selecting Components from the Component Palette . 3-10 Adding Components to the Layout Area . 3-13 Working with Components in the Layout Area . 3-16 Running the GUI . 3-19 Saving the Layout . 3-21 Renaming GUI Files . 3-21 Exporting a GUI to a Single M-File . 3-21 Displaying the GUI . 3-22 ii Contents Layout Editor Preferences . 3-22 Layout Editor Context Menus . 3-26 Selecting GUI Options . 3-28 Configuring the GUI M-File . 3-28 Resize Behavior . 3-29 Command-Line Accessibility . 3-30 Generate FIG-File and M-File . 3-32 Generate Callback Function Prototypes . 3-33 GUI Allows Only One Instance to Run (Singleton) . 3-35 Using the System Background Colors . 3-35 Generate FIG-File Only . 3-36 Aligning Components in the Layout Editor . 3-37 Aligning Groups of Components — The Alignment Tool . 3-37 Grids and Rulers . 3-39 Aligning Components to Guide Lines . 3-40 Front-to-Back Positioning . 3-41 Setting Component Properties — The Property Inspector 3-43 Displaying the Property Inspector . 3-43 What Properties Do I Need to Set? . 3-44 Some Commonly Used Properties . 3-45 Setting Properties for Some Specific Components . 3-46 Callback Properties . 3-54 Changing Tag and Callback Properties . 3-56 Viewing the Object Hierarchy — The Object Browser . 3-59 Creating Menus — The Menu Editor . 3-60 Defining Menus for the Menu Bar . 3-61 Menu Callbacks . 3-66 Defining Context Menus . 3-68 Setting the Tab Order — The Tab Order Editor . 3-72 iii Programming GUIs 4 Understanding the GUI M-File . 4-2 Sharing Data with the Handles Structure . 4-2 Functions and Callbacks in the M-File . 4-3 Opening Function . 4-4 Output Function . 4-5 Callbacks . 4-6 Input and Output Arguments . 4-7 Programming Callbacks for GUI Components . 4-8 Toggle Button Callback . 4-8 Radio Buttons . 4-9 Check Boxes . 4-10 Edit Text . 4-10 Sliders . 4-11 List Boxes . 4-11 Pop-Up Menus . 4-12 Panels . 4-13 Button Groups . 4-13 Axes . 4-14 ActiveX Controls . 4-17 Figures . 4-24 Managing GUI Data with the Handles Structure . 4-26 Example: Passing Data Between Callbacks . 4-26 Application Data . ..