User Interface Specification:
Options System

Author: Chris LeDantec

Document History

[March 26, 2002] Version 0 -- Inception.

[March 29, 2002] Version 0.1 -- First Draft.

[April 15, 2002] Version 0.2 -- Revision

[April 23, 2002] Version 0.3 -- Revision

[April 25, 2002] Version 1.0 -- Final Call Revision

[May 27, 2002] Version 1.01 -- Revisions to Java and Compilers panels. Added Java Bean Patterns dialog. NOTE: The tree on the left in the screenshots is not guaranteed to be up to date. For details on the structure of the tree please see the structure in the table of contents under Detailed Spec.

[May 28, 2002] Version 1.1 -- Revision to Javadoc options.

[June 18, 2002] Version 1.2 -- Revision to Network Options. Split browser and proxy options into two panels. Made revisions to browser panel based on requirements from web group. Created new screen shots for the new panels but did not update all screenshots. For an accurate tree please use the table of contents.

[August 19, 2002] Version 1.3 -- Revision to text. Clarified how options respond to addition and subtraction of modules/functionality.

[August 20, 2002] Version 1.4 -- Rework of content and document construction.

[August 29, 2002] Version 1.5 -- Moved Extensibility section to User View

[September 5, 2002] Version 2.0 -- Complete refresh of all dialogs. Many dialogs removed because of presumed changes with projects integration. Added Use Defaults button to all panels. Added Preview pane to all Fonts and Colors Dialogs.

[September 13, 2002] Version 2.1 -- Minor edits

[September 16, 2002] Version 2.2 -- Added Look and Feel combo to Environment General; Added 'New...' button to Indentation Panel (generally for all Service Types); Substantial Redesing of Java Import Panel; Logical grouping of VCS panel.

Table of Contents

Introduction

The Options System is being redesigned to simplify the task of setting up and customizing the IDE. The shift from property sheets to customizers characterizes the change in paradigm to present options in a more user and task centric manner as opposed to the modular or architectural presentation used to date.

In addition to the primary use of customizers, options have been broken into Base and Advanced groups. Base options will use customizers and are discussed directly in this specification. Advanced options will follow the property sheet model and are discussed in the Advanced Options Spec.

Context

To achieve greater focus on user centered needs, 5 elements where considered in the redesign:

  1. Greatly reduce the number of options the user has to work with. Options not presented in the Base Dialog will be available through the Advanced Dialog.
  2. Present options in a UI that is more natural for the option being changed.
  3. Add multiple entry points for customizing the IDE. This follows with the context sensitive nature of the IDE and lets users get at options relevant to the task at hand faster.
  4. Add explicit commit and cancel gestures. All options contained in the Options Dialog will only be committed to the system when the user clicks Ok. Clicking Cancel will ignore any changes made while the Dialog was open.
  5. Increase the barrier to entry for new options and thereby keep the number of Base Options to a reasonable level.

The following three areas are where the design elements are focused.

  1. Categories: Option categories will be based around user tasks thereby reducing redundancy and increasing the likelihood that the user will find the option that needs to be changed.
  2. Customizers: Options will be presented in customizer form as customizers do a better job of handling complex hierarchies and relating dependency between options.
  3. Interaction: The Options Dialog interaction will include Ok and Cancel buttons to fall in line with actions usually present in similar dialogs.

Overview of Functionality

The new Options System needs to have certain pieces of functionality in place in order to provide the kind of solution needed by users as well as provide certain flexibilities to leverage the benefit of NetBeans' modularity.

Supporting changes and functionality needs to come from:

  1. Menus
  2. Options Infrastructure
  3. Extensibility Support

    Menus

    Additional menu items will be added to the bottom of the listed menus.

    Menubar additions:

    • Project - 'Options'
    • Versioning - 'Options'

      Note: Change the mnemonic on 'Mount Version Control' to 'Mount Version Control'

    Popup menu additions:

    • Editor (border) - 'Options'
    • Editor (body) - 'Options' *See open issues [1]
    • Editor - 'Fonts and Colors...'
    • Editor - 'Keyboard Options'
    • Form Editor - 'Options'
    • Form Editor - 'Fonts and Colors...'
    • Form Editor Component Palette - 'Options'
    • Toolbar - 'Options'
    • Output Window - 'Options'
    • Output Window - 'Fonts and Colors...'
    • Property Sheet - 'Options'
    • Property Sheet - 'Fonts and Colors...'
    • Explorer nodes - 'Options'
    • Diff Popup | 'Options'
    • Diff Popup | 'Fonts and Colors...'

      Note: No mnemonics on popup menu items.

    Options Dialog Basics

    Behaviors and functionality for the Option System are described in more detail in the Options Dialog User View.

    The Options Infrastructure needs to provide functionality for:

Buttons

Dialog Wide Buttons
OK Commits changes and closes dialog.
Cancel Closes dialog without committing any changes.
Apply Commits changes and leaves dialog open (not currently part of the design but functionality should be available).
Advanced Opens Advanced Options dialog. See Advanced Options Spec for more details.
Base Opens Base Options dialog (when Advanced dialog is present).
Option Panel specific Buttons
Use Defaults Restores panel values to factory defaults

Options Category Tree

The Options Category Tree needs to include support for modules to add or subtract items in the tree as well as maintaining the same structure for both Base and Advanced Option Dialogs. See Options User View for more details.

Advanced Dialog Behavior

When the Advanced button is pressed the advanced dialog is opened. This opening consists of showing elements in the Category Tree that are not in the Base Options Tree and replacing the customizer on the right with a property sheet. The Advanced button will change its label to Base.

To this end the Category Tree needs to have the same basic structure for both Advanced and Base Options.

References

See the Options User View for more detail on how the functionality will be supported.

See the Advanced Options Spec for a description of the Advanced Options Dialog.

See the Options Guideline for developers.

A list of properties included in the current options system. The raw material this proposal was comprised of.

Detailed Spec

The Options Categories are listed here as a table of content for the Detailed Spec. Due to the evolving nature of the design and the shear number of dialogs to keep updated, the Category Tree in the screen shots are not all up to date. Please refer to this list as the definitive category list.

  • Projects
  • Java
  • Version Control
  • Overview of the Options Dialog

    The Options Dialog is broken into several categories. Each of category can contain sub-categories though the depth of the tree is usually designed to be no deeper than two levels.. Additional nesting of related options is done in the panels via a combo-box.

    Options Dialog - General Interaction

    General Environment Options
    General Interaction

    The users selects the category on the left that corresponds to what they want to change. The panel on the right displays the relevant option customizer.

    • Clicking Ok confirms any changes, applies them to the system and closes the Options Dialog.
    • Clicking Cancel closes the Options Dialog without applying any changes.
    • Clicking Help opens the help browser to help matching the current panel.
    • Clicking Advanced opens the Advanced Options Dialog with the tree expanded to the options related to what the user was doing in the Options Dialog.
    • Opening the Options Dialog will display which ever mode, Base or Advanced, that was last used.
    Entry Points

    Tools | Options

    Layout and Resize Behavior

    The Options Dialog is initially sized at 600 x 400. The left Options list should be a fixed size for the language content present. The rest of the dialog can be resized. If the user resizes the dialog it should always reappear at that new size.

    Tab Order

    Only when opened from Tools | Options

    Initial focus: First element in 'Options' list

    When the Options Dialog is accessed from a panel specific entry point then focus is initially on the first element in the selected panel. In all other cases initial focus is on a matching element in the 'Options' list.

    Tab order:

    1. First element in 'Options' list
    2. First element in selected options panel (focus goes to the right)
    3. Tab order of selected panel
    4. Advanced
    5. Ok
    6. Cancel
    7. Help

    Mnemonics

    • Options List (O)
    • Advanced (D)
    • Ok
    • Cancel
    • Help (H)

    In the description of each panel the global buttons listed here are omitted.

    Error Conditions

    Appropriate warning or information dialogs will appear when incorrect or bad data has been enter and Ok clicked. Any error dialog must be explicit in pointing where to rectify the problem as several changes may have occurred after the bad data was entered.

    Tooltips

    In most cases the tool tips should come from text used in the current Options Dialog

    Content to Cover in Online Help

    Help content should already exist though it will have to be reordered to reflect the way options have been aggregated in the new design.

    Environment

    The Environment options include IDE wide options including, look and feel, general setup, network and tools setup.

    General:

    Environment: General Options.
    Description

    These options apply to general aspects of the IDE.

    Properties Mapping
    • Use Look and Feel: not implemented yet -sets IDE look and feel to take affect after restart. Will prompt user with warning box.
    • MDI/SDI radio buttons: IDE Configuration | System | System | User Interface
    • Show Tip of the Day: IDE Configuration | System | System | Show Tips on Startup
    • Show Tooltips: IDE Configuration | System | System | Show Tool Tips In IDE
    • Confirm Delete: IDE Configuration | System | System | Confirm Delete
    • Show File Extensions in Explorer: IDE Configuration | System | System | Show File Extensions
    • Hide Read-only Properties: IDE Configuration | Look and Feel | Property Sheet | Display Editable Only
    • Sorting: IDE Configuration | Look and Feel | Property Sheet | Redirection Directory | Sorting Mode
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: MDI Window System radio button

    Tab order:

    1. Use Look and Feel
    2. MDI Window System radio button
    3. SDI Window System radio button
    4. Show Tip of the Day
    5. Show Tooltips
    6. Confirm Delete
    7. Show File Extensions in Explorer
    8. HOME Environment Variable Path (Text Field)
    9. Browse button
    10. Hide Read-only Properties
    11. Sorting
    12. Use Defaults

    Mnemonics
    • Use Look and Feel (U)
    • MDI Window System radio button (M)
    • SDI Window System radio button (S)
    • Show Tip of the Day (T)
    • Show Tooltips (L)
    • Confirm Delete (C)
    • Show File Extensions in Explorer (X)
    • HOME Environment Variable Path (Text Field) (P)
    • Browse button (B)
    • Hide Read-only Properties (R)
    • Sorting (G)
    • Use Defaults (D)

    Autoupdate:

    Autoupdate Options
    Description

    These options configure Autoupdate for the IDE. Text in the panel suggests where to go to setup a proxy server if one is needed and provides a link to jump straight to that panel.

    Properties Mapping
    • Ask Before Checking: IDE Configuration | System | Update Center | Ask Before Check
    • Show Results Even if Now Updates Found: IDE Configuration | System | Update Center | Show Negative Results
    • Check For Updates: IDE Configuration | System | Update Center | Check Period
    • Update Server: IDE Configuration | System | Update Center | Update Server
    • Server URL: IDE Configuration | System | Autoupdate Types | <Update Server type> | Server URL
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Ask Before Checking

    Tab order:

    1. Ask Before Checking
    2. Show Results Even if Now Updates Found
    3. Check For Updates combo box
    4. Update Server combo box
    5. Server URL text field
    6. Use Defaults

    Mnemonics
    • Ask Before Checking (B)
    • Show Results Even if Now Updates Found (R)
    • Check For Updates (C)
    • Update Server (U)
    • Server URL (S)
    • Use Defaults (D)

    Fonts and Colors:

    Description

    The Fonts and Colors panel is where all options are set for fonts and colors in the IDE. Editor fonts and colors, fonts and colors for IDE components (Output Window, Property Sheet, Diff tool), and process fonts and colors (printing) are all selected through the top combo box. The panel below the combo box contains the details for the object chosen

    Every panel provides a preview of how the colors will look in the correct context. This is true for all types of windows -from Editors to the Output Window.

    NOTE: The combo-box containing color names will also have a square with the actual color next to the name in the final version of the dialog.

    Fonts and Colors - Diff Colors:

    Fonts and Colors: Diff Colors
    Properties Mapping
    • Added Text: IDE Configuration | Server and External Tool Settings | Diff Types | Graphical Diff Viewer | Color of Added Text
    • Removed Text: IDE Configuration | Server and External Tool Settings | Diff Types | Graphical Diff Viewer | Color of Removed Text
    • Changed Text: IDE Configuration | Server and External Tool Settings | Diff Types | Graphical Diff Viewer | Color of Changed Text
    Entry Points

    Tools | Options

    Diff Popup | Fonts and Colors...

    Tab Order

    Initial focus: Use Internal Diff Tool

    Tab order:

    1. Show Options For combo box
    2. Added Text
    3. Removed Text
    4. Changed Text
    5. Use Defaults
    6. Preview area

    Mnemonics
    • Show Options For combo box (S)
    • Added Text (E)
    • Removed Text (R)
    • Changed Text (C)
    • Use Defaults (D)

    Fonts and Colors - Merge Colors:

    Fonts and Colors: Merge Colors
    Properties Mapping
    • Added Text: unknown
    • Removed Text: unknown
    • Changed Text: unknown
    Entry Points

    Tools | Options

    Diff Popup | Fonts and Colors...

    Tab Order

    Initial focus: Use Internal Diff Tool

    Tab order:

    1. Show Options For combo box
    2. Added Text
    3. Removed Text
    4. Changed Text
    5. Use Defaults
    6. Preview area

    Mnemonics
    • Show Options For combo box (S)
    • Added Text (E)
    • Removed Text (R)
    • Changed Text (C)
    • Use Defaults (D)

    Fonts and Colors - Source Editor:

    Fonts and Colors: Source Editor
    Description

    In the Show Options For combo box the user can select 'Source Editor'. Once 'Source Editor' is selected, all possible display items for all installed editors are shown in the 'Display Items' list. The name of the editor is append to the item name so editor items are grouped together (i.e. JSP: Tag, Java: Keyword, HTML: comment). At the top of the list will be all common items (text, keyword, etc) and when set will set the value for all editors containing those tokens. Each editor can override any token if the user sets the individual value.

    The Editor Preview pane shows the result for the selected editor. The pane will automatically switch to the type of editor that the selected display item is from. If the user switches the preview pane manually it will not follow Display Item selection for the rest of the session -resetting only after reopening the Options Dialog.

    Properties Mapping
    • Font: Editing | Editing Settings | <Editor Specific> Print Fonts and Colors
    • Size: Editing | Editing Settings | <Editor Specific> Print Fonts and Colors
    • Bold button: Editing | Editing Settings | <Editor Specific> Print Fonts and Colors
    • Italic button: Editing | Editing Settings | <Editor Specific> Print Fonts and Colors
    • <Display Item> Foreground: Editing | Editing Settings | <Editor Specific> Print Fonts and Colors
    • <Display Item> Background: Editing | Editing Settings | <Editor Specific> Print Fonts and Colors
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Show Options For combo box

    Tab order:

    1. Show Options For combo box
    2. Font
    3. Size
    4. Bold button
    5. Italic button
    6. Display Items list
    7. Foreground
    8. Custom
    9. Background
    10. Custom
    11. Use Defaults
    12. Preview combo

    Mnemonics
    • Show Options For combo box (S)
    • Font (F)
    • Size (Z)
    • Bold button
    • Italic button
    • Display Items list (I)
    • Foreground (G)
    • Custom
    • Background (K)
    • Custom
    • Use Defaults (D)
    • Editor Preview (P)

    Fonts and Colors - IDE Selection Colors:

    Fonts and Colors: IDE Selection Colors
    Properties Mapping
    • Active Selection Color: IDE Configuration | Look and Feel | Output Window | Selection Background and Editing | Editor Settings | <all editor types> | Fonts and Colors Selected Text Background *See open issues [2]
    • Inactive Selection Color: does not exist yet. *See open issues [3]
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Show Options For combo box

    Tab order:

    1. Show Options For combo box
    2. Active Selection Color
    3. Custom button
    4. Inactive Selection Color
    5. Custom button
    6. Use Defaults
    7. Preview

    Mnemonics
    • Show Options For combo box (S)
    • Active Selection Color (C)
    • Custom button
    • Inactive Selection Color (I)
    • Custom button
    • Use Defaults (D)

    Fonts and Colors - Form Editor:

    Fonts and Colors: Form Editor Options and Colors
    Properties Mapping
    • Selection Border Size: Editing | Form Editor Settings | Selection Border Size
    • Drag Color: Editing | Form Editor Settings | Drag Feedback Color
    • Form Designer Border: Editing | Form Editor Settings | Form Designer Border Color
    • Form Selection Border: Editing | Form Editor Settings | Selection Border Color
    • Canvas Background: Editing | Form Editor Settings | Form Designer Background Color
    • Connection Border Color: Editing | Form Editor Settings | Connection Border Color
    Entry Points

    Tools | Options

    Form Editor popup | Fonts and Colors...

    Tab Order

    Initial focus: Show Options For combo box

    Tab order:

    1. Show Options For combo box
    2. Selection Border Size
    3. Selection Border Color
    4. Custom
    5. Form Designer Border
    6. Custom
    7. Canvas Background
    8. Custom
    9. Drag Color
    10. Custom
    11. Connection Border Color
    12. Custom
    13. Use Defaults
    14. Preview

    Mnemonics
    • Show Options For combo box (S)
    • Selection Border Size (B)
    • Drag Color (R)
    • Custom
    • Form Designer Border (F)
    • Custom
    • Form Selection Border (E)
    • Custom
    • Canvas Background (C)
    • Custom
    • Connection Border Color (N)
    • Custom
    • Use Defaults (D)

    Fonts and Colors - Output Window:

    Fonts and Colors: Output Window

    Properties Mapping
    • Font Size: IDE Configurations | Look and Feel | Output Window | Font Size
    • Foreground: IDE Configurations | Look and Feel | Output Window | Foreground
    • Background: IDE Configurations | Look and Feel | Output Window | Background
    • Link Foreground: IDE Configurations | Look and Feel | Output Window | Jump Link Foreground
    • Link Background: IDE Configurations | Look and Feel | Output Window | Jump Link Background
    Entry Points

    Tools | Options

    Output Window popup | Fonts and Colors...

    Tab Order

    Initial focus: Show Options For combo box

    Tab order:

    1. Show Options For combo box
    2. Font Size
    3. Foreground
    4. Custom
    5. Background
    6. Custom
    7. Link Foreground
    8. Custom
    9. Link Background
    10. Custom
    11. Use Defaults

    Mnemonics
    • Show Options For combo box (S)
    • Font Size (F)
    • Foreground (R)
    • Custom
    • Background (B)
    • Custom
    • Link Foreground (G)
    • Custom
    • Link Background (K)
    • Custom
    • Use Defaults (D)

    Fonts and Colors - Print General:

    Fonts and Colors: Print General
    Properties Mapping
    • Header and Footer Font: IDE Configurations | System | Print Settings | Page Footer Font and Page Header Font selector
    • Size: IDE Configurations | System | Print Settings | Page Footer Font and Page Header Font selector
    • Bold button: IDE Configurations | System | Print Settings | Page Footer Font and Page Header Font selector
    • Italic button: IDE Configurations | System | Print Settings | Page Footer Font and Page Header Font selector
    • Header Text: IDE Configurations | System | Print Settings | Page Header Format
    • Header Alignment: IDE Configurations | System | Print Settings | Page Header Alignment
    • Footer Text: IDE Configurations | System | Print Settings | Page Footer Format
    • Foot Alignment: IDE Configurations | System | Print Settings | Page Footer Alignment
    • Wrap Lines: IDE Configurations | System | Print Settings | Wrap Lines
    • Print Line Numbers: IDE Configurations | System | Print Settings | <Editor Specific> Print Line Numbers
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Show Options For combo box

    Tab order:

    1. Show Options For combo box
    2. Header and Footer Font
    3. Size
    4. Bold button
    5. Italic button
    6. Header Text
    7. Header Alignment
    8. Footer Text
    9. Foot Alignment
    10. Wrap Lines
    11. Print Line Numbers
    12. Use Defaults

    Mnemonics
    • Show Options For combo box (S)
    • Header and Footer Font (F)
    • Size (Z)
    • Bold button
    • Italic button
    • Header Text (E)
    • Header Alignment (R)
    • Footer Text (T)
    • Foot Alignment (L)
    • Wrap Lines (W)
    • Print Line Numbers (N)
    • Use Defaults (D)

    Fonts and Colors - Print Editor:

    Fonts and Colors: Print Editors
    Description

    This panel works in the same way as the Source Editor panel -a list of all items for all installed editors allows the user to select the colors and fonts for printing.

    Properties Mapping
    • Font: IDE Configurations | System | Print Settings | <Editor Specific> Print Fonts and Colors
    • Size: IDE Configurations | System | Print Settings | <Editor Specific> Print Fonts and Colors
    • Bold button: IDE Configurations | System | Print Settings | <Editor Specific> Print Fonts and Colors
    • Italic button: IDE Configurations | System | Print Settings | <Editor Specific> Print Fonts and Colors
    • <Display Item> Foreground: IDE Configurations | System | Print Settings | <Editor Specific> Print Fonts and Colors
    • <Display Item> Background: IDE Configurations | System | Print Settings | <Editor Specific> Print Fonts and Colors

    In the Display Items list all items for the selected editor will be listed. The user will change the print colors for the selected editor here. This follows the Fonts and Colors model.

    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Show Options For combo box

    Tab order:

    1. Show Options For combo box
    2. Font
    3. Size
    4. Bold button
    5. Italic button
    6. Display Items list
    7. Foreground
    8. Custom
    9. Background
    10. Custom
    11. Use Defaults
    12. Preview combo

    Mnemonics
    • Show Options For combo box (S)
    • Font (F)
    • Size (Z)
    • Bold button
    • Italic button
    • Display Items list (I)
    • Foreground (G)
    • Custom
    • Background (K)
    • Custom
    • Use Defaults (D)
    • Preview combo (P)

    Fonts and Colors - Property Sheet:

    Fonts and Colors - Property Sheet
    Properties Mapping
    • Disabled Property: IDE Configurations | Look and Feel | Property Sheet | Disabled Property Color
    • Enabled Property: IDE Configurations | Look and Feel | Property Sheet | Value Color

    In the Display Items list all items for the selected editor will be listed. The user will change the print colors for the selected editor here. This follows the Fonts and Colors model.

    Entry Points

    Tools | Options

    Property Sheet Popup | Fonts and Colors...

    Tab Order

    Initial focus: Show Options For combo box

    Tab order:

    1. Show Options For combo box
    2. Disabled Property Color
    3. Custom
    4. Enabled Property Color
    5. Custom
    6. Use Defaults

    Mnemonics
    • Show Options For combo box (S)
    • Disabled Property Color (D)
    • Custom
    • Enabled Property Color (E)
    • Custom
    • Use Defaults (D)

    Keyboard:

    Keyboard Options: Lists all shortcuts.
    Description

    This includes the current Keybindings dialog into the Options system. The first combo-box lets the user select from several predefined keyboard mapping schemes (JBuilder, Visual Studio, etc). The keyboard mapping table is really a tree-table with the current tree of actions displayed on the left. The user edits the keybinding in the right hand cell by selecting the cell and then entering the shortcut. Some actions will let the user set more than one keybinding.

    The Shortcut Conflict text area indicates which action is in conflict with the entered shortcut.

    Properties Mapping
    • None
    Entry Points

    Tools | Options

    Editor Popup | Keyboard Options

    Tab Order

    Initial focus: Shortcuts Table

    Tab order:

    1. Keyboard Mapping Profile combo
    2. Keyboard Mapping table
    3. Use Defaults

    Mnemonics
    • Keyboard Mapping Profile combo (P)
    • Keyboard Mapping table (K)
    • Use Defaults (D)

    Error Conditions

    If the user enters a key combination that is already taken then a dialog warns them when focus moves away from the edited table cell.

    Output Window:

    Output Window Options
    Description

    Output Window Options. The Output File Path is not enabled until Redirect Output to File is checked.

    Properties Mapping
    • Open Output Window After Successful Compilation: IDE Configuration | Look and Feel | Output Window | Open after Successful Compilation
    • Reuse Output Tab for Ant: Building | Ant Settings | Reuse Output Tab
    • On Execution Output Window Should: Building | Ant Settings | Reuse Output Tab Executors
    • Tab Size: IDE Configuration | Look and Feel | Output Window | Tab Size
    • History Size: IDE Configuration | Look and Feel | Output Window | History Size
    • Redirect Output To File: IDE Configuration | Look and Feel | Output Window | Redirect to Output File
    • Output File Path: IDE Configuration | Look and Feel | Output Window | Redirection Directory
    Entry Points

    Tools | Options

    Output Popup | Options

    Tab Order

    Initial focus: Reuse Output Tab

    Tab order:

    1. Open Output Window After Successful Compilation
    2. Reuse Output Tab for Ant
    3. On Execution Output Window Should
    4. Tab Size
    5. History Size
    6. Redirect Output To File
    7. Output File Path
    8. Browse
    9. Use Defaults

    Mnemonics
    • Open Output Window After Successful Compilation (S)
    • Reuse Output Tab for Ant (A)
    • On Execution Output Window Should (E)
    • Tab Size (T)
    • History Size (Y)
    • Redirect Output To File (R)
    • Output File Path (O)
    • Browse (B)
    • Use Defaults (D)

    Proxy:

    Proxy Options
    Description

    This panel is where the user sets up the proxy server for use with in the IDE.

    Properties Mapping
    • Use Proxy: IDE Configuration | System | System | Use Proxy
    • Proxy Server: IDE Configuration | System | System | Proxy Host
    • Proxy Port: IDE Configuration | System | System | Proxy Port
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Use Proxy

    Tab order:

    1. Use Proxy
    2. Proxy Server
    3. Proxy Port
    4. No Proxy For
    5. Use Defaults

    Mnemonics
    • Use Proxy (U)
    • Proxy Server (S)
    • Proxy Port (R)
    • Use Proxy For (F)
    • Use Defaults (D)

    Toolbars:

    Toolbars Options
    Description

    This functionality needs to be implemented. On the left is a list of the actions in the selected Toolbar; on the right is a list of available actions that can be added to the toolbar.

    Properties Mapping
    • None
    Entry Points

    Tools | Options

    Property Sheet Popup | Options

    Tab Order

    Initial focus: Select Toolbar

    Tab order:

    1. Select Toolbar
    2. Toolbar Actions
    3. Up
    4. Left
    5. Right
    6. Down
    7. Available Actions
    8. Use Defaults

    Mnemonics
    • Select Toolbar (S)
    • Toolbar Actions (T)
    • Up
    • Left
    • Right
    • Down
    • Available Actions (B)
    • Use Defaults (D)

    Web Browser:

    Browser Options
    Description

    The user can select the default web browser for use within the IDE. This selection will be used for browsing to documents as well as the default for functionality that uses a web browser during development -such as JSP development.

    The items in the Browser combo-box depend on the system that the IDE is running on. Only choices for the type of system (Windows, Linux, Solaris) will be displayed.

    Properties Mapping
    • Browser Combo-box: IDE Configuration | System | System | Web Browser
    • Path: IDE Configuration | Server and External Tool Settings | Web Browsers | External Browser | Browser Executable
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Use Proxy

    Tab order:

    1. Browser
    2. Path
    3. Browse
    4. Use Defaults

    Mnemonics
    • Browser (R)
    • Path (P)
    • Browse (B)
    • Use Defaults (D)

    Editors

    The Editors options include all non-color options for the various editors in the IDE.

    General:

    General Settings apply to all editors.
    Description

    These options apply to the source editor window and will be applied across all source editor windows regardless of what specific type of editor they contain.

    Properties Mapping
    • Show Status Bar: Editing | Editor Settings | <type> Editor | Advanced | Status Bar Visible
    • Show Editor Toolbar: Editing | Editor Settings | Toolbar Visible
    • Show Line Numbers: Editing | Editor Settings | <type> Editor | Line Numbers
    • Show Text Limit Line: Editing | Editor Settings | <type> Editor | Advanced | Display Text Limit Line
    • Highlight Matching Bracket: Editing | Editor Settings | <type> Editor | Advanced | Highlight Matching Bracket
    • Show Glyph Margin: Editing | Annotation Types | Always Show Glyph Margin
    • Insertion Carat: Editing | Editor Settings | Insertion Pointer
    • Overwrite Carat: Editing | Editor Settings | Overwrite Carat
    Entry Points

    Tools | Options

    Editor (border) popup | Options

    Tab Order

    Initial focus: Show Status Bar checkbox

    Tab order:

    1. Show Status Bar
    2. Show Editor Toolbar
    3. Show Glyph Margin
    4. Show Line Numbers
    5. Show Text Limit Line
    6. Show Highlight Matching Bracket
    7. Insertion Carat
    8. Italic
    9. Overwrite Carat
    10. Italic
    11. Use Defaults

    Mnemonics
    • Show Status Bar (S)
    • Show Editor Toolbar (E)
    • Show Glyph Margin (G)
    • Show Line Numbers (L)
    • Show Text Limit Line (T)
    • Show Highlight Matching Bracket (M)
    • Insertion Carat (I)
    • Italic
    • Overwrite Carat (V)
    • Italic
    • Use Defaults (D)

    Abbreviations:

    Editors: Abbreviations Options.
    Description

    The Abbreviations panel applies to all types of editors. A user can customize abbreviations per editor in the Advanced Options Dialog -those changes will not be visible here. New abbreviations are entered with their matching string into the text fields under the combo. When the abbreviation and expanded string are complete clicking Add will add them to the table below. Editing existing abbreviations is done in place in the table. To remove an abbreviation the user selects the abbreviations to delete and clicks on Remove or presses the 'Delete' key.

    Properties Mapping
    • Abbreviation: Editing | Editor Settings | <type> Editor | Abbreviations custom editor
    • Expanded String: Editing | Editor Settings | <type> Editor | Abbreviations custom editor
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Show Abbreviations For

    Tab order:

    1. Abbreviations
    2. Expanded String
    3. Add
    4. List of Abbreviations table
    5. Table internal tab order
    6. Remove
    7. Use Defaults

    Mnemonics
    • Abbreviations (B)
    • Expanded String (X)
    • Add
    • List of Abbreviations table (L)
    • Remove
    • Use Defaults (D)

    Indentation Engine:

    Editors: Indentation Engine.
    Description

    Use selects the Indention Engine to customize in the 'Select Indentation Profile:' combo box. Indention Engine specific options are displayed below. The Preview pane shows an example of what the code formatting will look like.

    Properties Mapping
    • Select Indentation Profile: Editing | Indentation Engine | <type> Engine
    • Add Newline Before Brace: Editing | Indentation Engine | <type> Engine | Add Newline Before Brace
    • Number of Spaces per Tab: Editing | Indentation Engine | <type> Engine | Number of Spaces per Tab
    • Add Space Before Parenthesis: Editing | Indentation Engine | <type> Engine | Add Space Before Parenthesis
    • Expand Tabs to Spaces: Editing | Indentation Engine | <type> Engine | Expand Tabs to Spaces
    • Add Leading Star in Comments: Editing | Indentation Engine | <type> Engine | Add Leading Start in Comments
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Show Indentation Options For

    Tab order:

    1. Select Indentation Profile
    2. New...
    3. Save As...
    4. Delete
    5. Add Newline Before Brace
    6. Number of Spaces per Tab
    7. Add Space Before Parenthesis
    8. Expand Tabs to Spaces
    9. Add Leading Star in Comments
    10. Use Defaults
    11. Preview

    Mnemonics
    • Select Indentation Profile(S)
    • New...
    • Save As...
    • Delete
    • Add Newline Before Brace (N)
    • Number of Spaces per Tab (M)
    • Add Space Before Parenthesis (B)
    • Expand Tabs to Spaces (X)
    • Add Leading Star in Comments (L)
    • Use Defaults (D)

    Editors - Java (as example of other source editors):

    Editors: Java Editor Options.
    Description

    Each editor in the IDE is listed under Editor. For the current state of editors in NetBeans, all editors will provide a panel like what is shown for Java Editor.

    Each editor type is listed below with the options that they will display.

    Plain Editor, Properties Editor, CSS Editor:

    • Indentation Engine

    HTML Editor:

    • Show Auto-Completions
    • Indentation Profile
    Properties Mapping
    • Show Auto-completion: Editing | Editor Settings | Java Editor | Auto Popup Completion Window
    • Use Indentation Engine: Editing | Editor Settings | <type> Editor | Indentation Engine
    Entry Points

    Tools | Options

    Editor Popup | Options

    Tab Order

    Initial focus: Show Options For

    Tab order:

    1. Show Auto-Completion
    2. Use Indentation Engine
    3. Use Defaults

    Mnemonics
    • Use Indentation Engine (I)
    • Show Auto-Completion (C)
    • Use Defaults (D)

    Editors - Form Editor:

    Editors: Form Editor Options.
    Description

    The Form Editor panel contains options for the Form Editor

    Properties Mapping
    • Generate Code Immediately: Editing | Form Editor Settings | Use Deferred Code Generation
    • Indentation Engine: Editing | Form Editor Settings | Use Indentations Engine
    • Generated Variable Access: Editing | Form Editor Settings | Expert | Variables Modifier
    • static: Editing | Form Editor Settings | Expert | Variables Modifier
    • final: Editing | Form Editor Settings | Expert | Variables Modifier
    • synchronized: Editing | Form Editor Settings | Expert | Variables Modifier
    • volatile: Editing | Form Editor Settings | Expert | Variables Modifier
    • native: Editing | Form Editor Settings | Expert | Variables Modifier
    • abstract: Editing | Form Editor Settings | Expert | Variables Modifier
    Entry Points

    Tools | Options

    Form Editor Popup | Options

    Tab Order

    Initial focus: Show Options For

    Tab order:

    1. Indentation Engine
    2. Generate Code Immediately
    3. Generated Variable Access
    4. static
    5. final
    6. synchronized
    7. volatile
    8. native
    9. abstract
    10. Use Defaults

    Mnemonics
    • Indentation Engine (I)
    • Generate Code Immediately (G)
    • Generated Variable Access (V)
    • static (S)
    • final (F)
    • synchronized (Y)
    • volatile (L)
    • native (N)
    • abstract (A)
    • Use Defaults (D)

    Editors - Form Component Palette:

    Editors: Form Component Palette Options.
    Description

    The Form Editor component palette specific options are displayed in this panel. Above the list the user selects which palette to customize. Clicking on Add with bring up the Customize Bean dialog that lets users add beans to the component palette.

    Properties Mapping
    • Component Palette Size: Editing | Form Editor Settings | Component Palette
    • Show Names of Components: Editing | Form Editor Settings | Component Palette Shows Names
    Entry Points

    Tools | Options

    Component Palette Popup | Options

    Tab Order

    Initial focus: Show Options For

    Tab order:

    1. Component Palette List
    2. Show Names of Components
    3. Component Palette
    4. Add
    5. Remove
    6. Move Up
    7. Move Down
    8. Use Defaults

    Mnemonics
    • Component Palette List (C)
    • Show Names of Components (S)
    • Component Palette (P)
    • Add (A)
    • Remove (R)
    • Move Up (U)
    • Move Down (W)
    • Use Defaults (D)

    Editors - XML:

    Editors: XML
    Description

    Panel for editing XML Editor options.

    Properties Mapping
    • Show Auto-completion: Editing | Editor Settings | XML Editor | Auto Popup Completion Window
    • Open XML Files With: Editing | XML | General Settings | Expert tab | Default XML Action
    • Use Indentation Engine: Editing | Editor Settings | XML Editor | Indentation Engine
    Entry Points

    Tools | Options

    Editor Popup | Options

    Tab Order

    Initial focus: Show Options For

    Tab order:

    1. Show Auto-Completion
    2. Open XML Files With
    3. Use Indentation Engine
    4. Use Defaults

    Mnemonics
    • Use Indentation Engine (I)
    • Open XML Files With (X)
    • Show Auto-Completion (C)
    • Use Defaults (D

    Projects

    Projects options include options for setting up the project system.

    General:

    Projects
    Description

    There is only one general option for the projects.

    Properties Mapping
    • Projects Path: does not exist yet -specifies where the project should be stored.
    Entry Points

    Tools | Options

    Projects | Options

    Node in Project Explorer Popup | Options

    Tab Order

    Initial focus: Projects Path

    Tab order:

    1. Projects Path
    2. Browse
    3. Use Defaults

    Mnemonics
    • Projects Path (P)
    • Browse
    • Use Defaults (D)

    Java Language Support - General:

    Java General. 
    Properties Mapping

    Options for the Java language support are included here under three categories.

    Properties Mapping
    • Show Source Status: Editing | Java Sources | Show Compile Status
    • Pre-Parse Sources: Editing | Java Sources | Prescan Sources
    • Enable Synchronization: Editing | Java Sources | Source Synchronization | Synchronization Enabled
    • Source File Encoding: Code Documentation | Javadoc Executors | External Javadoc | Encoding
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Show Options For

    Tab order:

    1. Show Source Status
    2. Pre-Parse Source
    3. Enable Synchronization
    4. Source File Encoding
    5. Use Defaults

    Mnemonics
    • Show Options For (S)
    • Show Source Status (W)
    • Pre-Parse Source (P)
    • Enable Synchronization (E)
    • Source File Encoding (F)
    • Use Defaults (D)

      Java - Bean Patterns:

    Java Bean Patterns 
    Properties Mapping
    • Bind New Properties: Editing | Beans Property | Property is Bound
    • Constrain New Properties: Editing | Beans Property | Property is Constrained
    • New Indexes have Indexed Access: Editing | Beans Property | Indexed Property Has Indexed Access
    • Use Inheritance in Superclass: Editing | Beans Property | Use Inheritance in Superclass Without Prompting
    • Generate Access Types: Editing | Beans Property | Property Access Types
    • Declaration Style: Editing | Beans Property | Type of Declared Variable
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Show Options For

    Tab order:

    1. Bind New Properties
    2. Constrain New Properties
    3. New Indexes have Indexed Access
    4. Use Inheritance in Superclass
    5. Generate Access TypesDelaration Style
    6. Use Defaults

    Mnemonics
    • Bind New Properties (B)
    • Constrain New Properties (P)
    • New Indexes have Indexed Access (I)
    • Use Inheritance in Superclass (S)
    • Generate Access TypesDelaration Style (G)
    • Use Defaults (D)

    Java - Import Management:

    Java Import Management. 
    Properties Mapping
    • Create Import Statement Radio Button Group: Editing | Java Sources | Import Management Tool Settings | Fully Qualified Name Threshhold
    • Import Statement Type: Editing | Java Sources | Import Management Tool | Wildcard Import Threshold
    • Search List of Well-Known Packages for Unresolved Identifiers: Editing | Java Sources | Import Management Tool Settings | Guessing Strategy for Unresolved Identifiers.
    Entry Points

    Tools | Options

    Tab Order

    Initial focus: Show Options For

    Tab order:

    1. For All Identifiers
    2. For Identifiers with More Than
    3. Number combo-box
    4. Never (Use Fully-Qualified Names)
    5. Import Statements Type
    6. Search List of Well-Known Packages for Unresolved Identifiers

    Mnemonics
    • For All Identifiers (A)
    • For Identifiers with More Than (I)
    • Number combo-box
    • Never (Use Fully-Qualified Names) (N)
    • Import Statements Type (S)
    • Search List of Well-Known Packages for Unresolved Identifiers (W)

    Versioning Control:

    Versioning Control
    Description

    This dialog sets the global VCS options.

    Properties Mapping
    • Work Offline: Version Control Settings | Offline Mode
    • Apply These Options to All VCS Filesystems: Version Control Settings | Override Filesystem Settings
    • Show Advanced Options Hints: Version Control Settings | CVS Client | Show Advanced Options Hints
    • Auto Refresh: Version Control Settings | Auto Refresh
    • CVs Output Formatting: Version Control Settings | CVs Client Settings | Output Display
    • Annotation Formatting: Version Control Settings | CVs Client Settings | Annotation Formatting
    • Enable VCS Groups: Version Control Settings | VCS Groups | Disable VCS Groups
    • Show Full File Path: Version Control Settings | VCS Groups | Show Links
    • Move Modified Files to VCS Group: Version Control Settings | VCS Groups | Auto Addition
    • HOME Environment Variable Path: Source Creation and Management | Version Control Settings | Home Directory
    Entry Points

    Tools | Options

    Versioning | Options

    Tab Order

    Initial focus: Work Offline

    Tab order:

    1. Work Offline
    2. Show Advanced Options Hints
    3. Auto Refresh
    4. CVs Output Formatting
    5. Annotation Pattern
    6. Enable VCS Groups
    7. Show Full File Path
    8. Move Modified Files to VCS Group
    9. Path to CVs Configuration Files
    10. Browse
    11. Apply these Settings to All VCS Filesystems
    12. Use Defaults
    Mnemonics
    • Work Offline (W)
    • Show Advanced Options Hints (A)
    • Auto Refresh (R)
    • CVs Output Formatting (F)
    • Annotation Pattern (P)
    • Enable VCS Groups (E)
    • Show Full File Path (S)
    • Move Modified Files to VCS Group (M)
    • Path to CVs Configuration Files (V)
    • Browse (B)
    • Apply these Settings to All VCS Filesystems (L)
    • Use Defaults (D)

    Diff:

    Diff Options
    Description

    Options for the IDE's Diff tool. Set the Diff Engine in the first combo-box. Options specific to the engine are displayed in the bordered panel below the combo-box. If there are no options, as there are none for the Internal Diff Engine, the panel has the centered text 'No Options for the selected Engine'. The same applies to the second combo-box border panel pair below.

    Properties Mapping
    • Diff Engine: IDE Configuration | Server and External Tool Settings | Diff Settings | Default Diff Provider
    • Command Line Diff Path: IDE Configuration | Server and External Tool Settings | Diff Settings | Default Diff Provider
    • Diff Visualizer: IDE Configuration | Server and External Tool Settings | Diff Settings | Default Diff Visualizer
    • Context Mode: IDE Configuration | Server and External Tool Settings | Diff Settings | Default Diff Visualizer
    • Show Diff Service Selector: unknown
    Entry Points

    Tools | Options

    Diff Popup | Options

    Tab Order

    Initial focus: Use Internal Diff Tool

    Tab order:

    1. Diff Engine
    2. Command Line Diff Path
    3. Diff Visualizer
    4. Context Mode
    5. Number of Context Lines
    6. Show Diff Service Selector
    7. Use Defaults

    Mnemonics
    • Diff Engine (E)
    • Command Line Diff Path (C)
    • Diff Visualizer (V)
    • Context Mode (M)
    • Number of Context Lines (N)
    • Show Diff Service Selector (S)
    • Use Defaults (D)

    Required Graphics

    None.

    Open Issues

    1. Add the Options item to popups that come from the title bar, gutter, status bar of the editor. Places that apply to the whole window.
    2. This option needs a little more work because it should apply to all active and selected items in the IDE. The selection color should be the same everywhere.
    3. This option needs to be added to resolve the problem of inconsistent selection colors in the IDE and clear indication of which object is currently active and selected. This property pertains to selected but inactive objects in the IDE.

    Project Features

    About this Project

    ui was started in November 2009, is owned by Jiří Kovalský, and has 37 members.
    By use of this website, you agree to the NetBeans Policies and Terms of Use (revision 20131025.e7cbc9d). © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo
     
     
    Close
    loading
    Please Confirm
    Close