RESOURCE AND PATIENT MANAGEMENT SYSTEM GUI Programming Standards and Conventions Version 1.0 October 2010 Office of Information Technology (OIT) Division of Information Resource Management Albuquerque, New Mexico GUI Programming Standards and Conventions Version 1.0 Table of Contents 1.0 Purpose, Policy, and Standards and Conventions ................................1 1.1 Purpose .........................................................................................1 1.2 Policy .............................................................................................1 1.2.1 Conformance ...............................................................................1 2.0 GUI Programming Standards and Conventions ....................................2 2.1 Acceptable Icons ...........................................................................2 2.1.1 Icons–Application and Application Launch Level .........................2 3.0 GUI Programming Standards–UI Document Addendum .......................3 3.1 Custom Control (Beginning on Page 29) .......................................3 3.1.1 Custom Controls: Animations ......................................................3 3.1.2 Transition Animations ..................................................................4 3.1.3 Feedback Animations ..................................................................4 3.1.4 Progressive Disclosure ................................................................4 3.2 Direct Manipulation (Page 32) .......................................................4 3.2.1 Hosting in Browser: .....................................................................5 3.3 Balloons (Page 40) ........................................................................5 3.3.1 Passwords and PIN .....................................................................5 3.3.2 Balloons Accessibility ..................................................................6 3.3.3 Title Text ......................................................................................6 3.3.4 Body Text ....................................................................................6 3.3.5 Documentation ............................................................................7 3.3.6 Don’t Show This <item> Again ....................................................9 3.3.7 Subordinate Controls ...................................................................9 3.3.8 Default Values .............................................................................9 3.3.9 Labels ..........................................................................................9 3.4 Command Buttons (Page 54) ...................................................... 10 3.4.1 Using Ellipses ............................................................................ 11 3.4.2 Command Button Usage ........................................................... 11 3.4.3 Split Buttons .............................................................................. 12 3.4.4 Default Values ........................................................................... 12 3.4.5 Recommended Sizing And Spacing .......................................... 13 3.4.6 Labels ........................................................................................ 13 3.4.7 Command Links ......................................................................... 15 3.4.8 Dropdown List and Combo Boxes ............................................. 19 3.4.9 Editable List Boxes .................................................................... 20 3.4.10 Usage Patterns .......................................................................... 21 3.4.11 Drop-Down Lists ........................................................................ 21 3.4.12 Combo Boxes ............................................................................ 22 3.5 Default Values (Page 87) ............................................................. 22 3.5.1 Prompts ..................................................................................... 22 3.5.2 Labels ........................................................................................ 23 3.5.3 Option Text ................................................................................ 23 October 2010 <Table of Contents ii GUI Programming Standards and Conventions Version 1.0 3.5.4 Instructional Text ....................................................................... 24 3.5.5 Group Boxes.............................................................................. 24 3.6 Guidelines (Page 94) ................................................................... 25 3.6.1 Labels ........................................................................................ 25 3.6.2 Using Links ................................................................................ 26 3.6.3 Guidelines ................................................................................. 27 3.6.4 Color .......................................................................................... 27 3.6.5 Underlining ................................................................................ 27 3.6.6 Text with Icon Links ................................................................... 27 3.6.7 Graphics-Only Links .................................................................. 28 3.6.8 Navigation Links ........................................................................ 28 3.6.9 Task Links ................................................................................. 28 3.7 Menu Links (Page 102) ................................................................ 28 3.7.1 Link Infotips ............................................................................... 29 3.7.2 Text ........................................................................................... 29 3.7.3 Navigation Links ........................................................................ 29 3.7.4 Task Links ................................................................................. 30 3.7.5 Link Infotips ............................................................................... 30 3.8 List Boxes (Page 105) ................................................................. 30 3.8.1 Is This The Right Control? ......................................................... 30 3.8.2 Single-Selection Lists ................................................................ 30 3.8.3 Standard Multiple-Selection Lists And Check Box Lists ............ 31 3.8.4 Preview Lists ............................................................................. 31 3.8.5 List Builders And Add/Remove Lists .......................................... 31 3.8.6 Guidelines ................................................................................. 32 3.9 Multiple-Selection Lists (Page 113) ............................................. 33 3.9.1 Default Values ........................................................................... 33 3.9.2 Labels ........................................................................................ 34 3.9.3 Option Text ................................................................................ 34 3.9.4 Instructional And Supplemental Text ......................................... 34 3.10 List Views (Page 17) .................................................................... 35 3.10.1 Is This The Right Control? ......................................................... 35 3.10.2 Check Box List Views ................................................................ 35 3.10.3 Guidelines ................................................................................. 35 3.10.4 Interaction .................................................................................. 36 3.10.5 Multiple-Selection Lists .............................................................. 37 3.10.6 Changing Views ......................................................................... 37 3.11 Recommended Sizing And Spacing (Page 127) .......................... 38 3.11.1 Labels ........................................................................................ 39 3.11.2 Data Text ................................................................................... 39 3.11.3 Progress Bars ............................................................................ 40 3.11.4 Guidelines ................................................................................. 40 3.11.5 Determinate Progress Bars ....................................................... 42 3.11.6 Indeterminate Progress Bars ..................................................... 43 3.11.7 Modeless Progress Bars ........................................................... 43 3.12 Modal Progress Bars (Page 137) ................................................ 43 October 2010 <Table of Contents iii GUI Programming Standards and Conventions Version 1.0 3.12.1 Time Remaining ........................................................................ 43 3.12.2 Progress Bar Colors .................................................................. 44 3.12.3 Meters ....................................................................................... 44 3.12.4 Labels ........................................................................................ 45 3.12.5 Cancel Button ............................................................................ 46 3.12.6 Progress Dialog Box Titles ........................................................ 46 3.13 Progressive Disclosure