FILE (EDITOR) WINDOW

8.16 FILE (EDITOR) WINDOW

A File window contains the source code for your application. You may open an existing source code text file in this window (File>Open) or open a blank window and type in your code (File>New). Once you have included a file in a project, and if you have it open when saving the project, it will open every time you open your project (Project>Open).

Text in a file window is edited using the MPLAB Editor. See documentation for the editor for more on its operation.

• File Window Display • File Window Menu • File Window FAQ

8.16.1 File Window Display

You may split the File window by clicking and dragging on the rectangular “nub” before the scroll arrow (see image below). Splitting the window allows you to view different sections of long code.

Nub There is a right mouse button menu available in this window which contains several text

editing and debugging options. Additional text editing options may be found in the Edit menu (see MPLAB Editor help for more information.) Additional debugging options may

be found on the Debugger menu (after you have selected a debug tool.) Code execution information may be displayed in the form of symbols in the gutter of the

window. If you mouseover (more your cursor over) a variable, the variable address is displayed

in a pop-up.

DS51519A-page 126

 2005 Microchip Technology Inc.

MPLAB IDE Windows

8.16.2 File Window Menu

Below are the menu items in the File window right mouse button menu. • Remove All Filter Traces

Remove all filter trace tags on code text. See Section 11.5 “Working with Debug Features”.

• Add Filter-in Trace Add filter-in trace tags on selected code text. See Section 11.5 “Working with

Debug Features”. • Add Filter-out Trace Add filter-out trace tags on selected code text. See Section 11.5 “Working with

Debug Features”. • Remove Filter Trace Remove filter trace tags on selected code text. See Section 11.5 “Working with

Debug Features”. • Close Close active window. • Set/Remove Breakpoint Set or remove a breakpoint at the currently-selected line. • Enable/Disable Break

Enable or disable a breakpoint at the currently selected line. • Breakpoints Disable, enable or remove all breakpoints. • Run to Cursor Run the program to the current cursor location. Formerly Run to Here. • Set PC at Cursor Set the program counter (PC) to the cursor location. • Cut Deletes the selected text in the current window and places it on the clipboard.

After this operation you can paste the deleted text into another MPLAB Editor window, into a different location in the same MPLAB Editor window, or into another Windows application.

• Copy Copies the selected text in the current window onto the clipboard. After this

operation, you can paste the copied text into another MPLAB Editor window, into another location in the same MPLAB Editor window, or into another Windows application.

• Paste Pastes the contents of the clipboard into the current window at the insertion point.

You can only perform this operation if the clipboard contains data in text format. MPLAB Editor does not support pasting of bitmaps or other clipboard formats.

• Delete Deletes the selected text. • Add to Project Insert file into the current project. Depending on the type of file, MPLAB IDE will

sort the file into the correct type within the project window tree.

 2005 Microchip Technology Inc.

DS51519A-page 127

MPLAB ® IDE User’s Guide

• Advanced Set advanced text features. Make selected text all uppercase or lowercase, a

comment or not a comment, indented or outdented or match it if a brace, bracket or parenthesis.

• Bookmark Manage bookmarks. Toggle (enable/disable) a bookmark, move to the next or

previous bookmarks or clear all bookmarks. See MPLAB Editor on-line help for more on bookmarks.

• Text Mode Customize text display based on development mode, i.e., device architecture and

programming language. • Properties Set Editor Options, either display or functional options. See Section 11.2.1

“Editor Options Dialog”.

8.16.3 File Window FAQ

How do I: • Color my code based on its type?

MPLAB IDE will automatically color your code. To change this setting, right-click in the window, select Text Mode and then select your desired type, either device-specific assembly, C, Basic or SCL (simulator control language).

• Set the color-coding? Right-click in the window and select Properties. In the Editor Options dialog, click

the Text tab and Choose Colors.

DS51519A-page 128

 2005 Microchip Technology Inc.