Difference between revisions of "Settings dialog"

From TED Notepad
Line 57: Line 57:
  
 
The {{field|Exit by Esc}} setting enables or disables the {{hotkey|Esc}} and {{hotkey|Shift+Esc}} hotkeys.
 
The {{field|Exit by Esc}} setting enables or disables the {{hotkey|Esc}} and {{hotkey|Shift+Esc}} hotkeys.
 +
 +
====Full path in caption====
 +
 +
The {{field|Full path in caption}} setting enables to display the full document path (including drive letter and directory path) in the caption of the main window, instead of the simple document name.
  
 
====Show recently opened files====
 
====Show recently opened files====

Revision as of 14:23, 15 April 2007

You see work in progress here; this section already reflects future TED Notepad version 5.2.0.2.
This section may contain incomplete, premature, or mistaken information, prone to change without notice.

General page

Tab Size

The Tab Size value specifies the size of each tab stop. These tab stops determine, how much each Tab character will shift the following text.

Left Margin

The Left Margin value specifies the size of the left selection margin. This selection margin is a space between the text of the document and a border of the main window. Here a user can drag the mouse cursor to quickly select entire lines.

Text Limit

The Text Limit value specifies the maximum allowed length of text of a document. If this value is to be breached, text may be truncated and a warning will be given. Use this limit in order to create a top limit for your documents. If no such limit is required, leave zero in this field.

Versions note: Prior to version 4.5.2, this value could be altered any time in order to be able to edit a document of whatever size, but a specific positive value must have always been chosen. Version 4.5.2 allows to leave this field with zero value for no actual limit.

Persistent selection in Tools

The Persistent selection in Tools setting specifies whether the selection should outlast all used tools. If checked, the selection will be updated to re-cover the results of any used tool. Otherwise, the selection will be discarded and the caret will be placed at the end of such results (exactly as if the results of that tool were pasted to the document using a clipboard).

Note: For some tools (e.g. Indent selection with Tabs or Quote Mail) the selection always persits, because these tools are ment to be used several times in sequence on the same selection.

Tip: Such a setting may become useful especially, when you need to perform several tools in sequence on the same text. Imagine that you need to use Unique Lines tool and then additional Sort on the uniqued lines. When this setting is enabled, the selection will automatically cover the results of the first tool, thus you may use the second tool without need to re-select the text.

Auto-indent text

The Auto-indent text setting specifies, whether an auto-indentation mode is to be used. When turned on, each time a new line is being started (using the Enter key), Smart Return feature (hotkey Ctrl+Enter) is used instead. The Smart Return starts a new line as usual, but also copies all initial white-spaces from the previous line to the new line to reach the current text indentation. See chapter Edit menu for details.

Insert Spaces instead of Tab

The Insert Spaces instead of Tab setting specifies, whether to use a Tab character when a Tab key is pressed, or whether to insert Spaces instead. The number of Spaces inserted depends on the actual position of the caret on the line and also on the Tab Size setting.

Note: While using a fixed-width font, the resulting white space of inserted Spaces should be the same, as if a real Tab was inserted. This, however, does not always work with proportional fonts. In proportional fonts, size of a Space character often differ from a base character width. Therefore, there may be a difference between a real Tab size and a spaced Tab size. This feature is primarily meant for fixed-width fonts only.

Include underscores within words

The Include underscores within words setting specifies whether an Underscore character should be included within the definition of the word letters. This definition is used when working with words, like Select Word or Complete Word features do.

Note: Other characters, those that are not included within the word letters are furthermore divided into two groups: white-spaces and word delimiters. All word-oriented features of TED Notepad (e.g. Select Word) usually treat all white-spaces as one delimiting character. In other words, Select Word selects either a word or all consecutive white-spaces or a single word delimiter otherwise.

Line numbers unwrapped

The Line numbers from unwrapped lines setting specifies whether the lines of a document are to be counted according to the actual word wrapping or not. Turn this setting on to count the lines unwrapped, even while they are being word wrapped.

The number of the actual line is displayed in the Status Bar and may be used, for example, in the [[Control:Button:Go to Line:{{{2}}}|{{{2}}}]] feature.

Warning: Re-calculating of unwrapped lines is not a well-supported operation by the standard Windows edit box. It may noticeably slow down the system performance, when used with longer documents! With a very long document, the application may even stop responding. It may take a long time then to open the Settings dialog to turn this setting off. Use this setting with caution.

Complete Word dialog sorted

The Complete Word dialog sorted setting specifies whether the Complete Word dialog items are to be sorted alphabetically, or shown according to their preceding order in the document. See chapter Edit menu for more details about the Complete Word feature.

Exit by Esc

The Exit by Esc setting enables or disables the Esc and Shift+Esc hotkeys.

Full path in caption

The Full path in caption setting enables to display the full document path (including drive letter and directory path) in the caption of the main window, instead of the simple document name.

Show recently opened files

The Show recently opened files setting specifies whether the Recent Files menu is to be active. The Recently opened files are always maintained, but they are saved upon Exit only when this setting is turned on.

Note: To save Recent Files succesfully, no /ns command line parameter, nor the Exit without saving! may take their place. See chapters Command line parameters and File menu.

Empty recent files menu

The [[Control:Button:Empty recent files menu:{{{2}}}|{{{2}}}]] button empties the list of the Recently opened files.

Fixed-width Font, Proportional Font

The Fixed-width Font specifies whether the default system fixed-width font is to be used as a fixed-width font or a custom user's font. Use the Primary font button to choose this custom user's font.

The Proportional Font specifies whether a default system font is to be used as a proportional font or a custom user's font. Use the Secondary font button to choose this custom user's font.

Use multi-level Undo/Redo

Template:Specific The Use multi-level Undo/Redo turns on/off the multi-level Undo/Redo feature. See chapter RichEdit clone.

Clear Undo buffer upon Save

Template:Specific The Clear Undo buffer upon Save specifies whether to forget all multi-level actions upon the Save operation. The last action remains remembered anyway. This option has no effect when Use multi-level Undo/Redo option is turned off. See chapter RichEdit clone.

Automatic detection of URLs

Template:Specific The Automatic detection of URLs specifies whether URLs are to be detected and highlighted in the document. Note: It may be necessary to reload somehow the text of the document after applying of the settings/options to get the autodetection fully working. This is because only loaded or somehow modified text is searched for URLs and each apply of the settings/options may discard all previously found links. See chapter RichEdit clone.

Use doubleclick to launch URLs

Template:Specific The Use doubleclick to launch URLs specifies whether a doubleclick or a single click on an auto-detected URL is required to launch it in a default internet browser. See chapter RichEdit clone.

File page

Default encoding

The Default encoding specifies a default file encoding that should be used for new documents. Supported encodings are ANSI, both Unicodes and UTF-8.

Note: See chapter Managing documents for more informations about these file encodings, their usage, advantages and also their pitfalls.

Default newlines

The Allow UNIX/Mac newlines support specifies whether the transparent UNIX/Mac newlines support is to be available.

See chapter Managing documents for more details about transparent newlines support.

Open/Save dialog filters

The Open/Save dialog filters defines filters, that are to be used in the Open/Save dialogs as file filters. They appear in a combo-box, usually bellow the file name box. Such a filter consists of two strings separated by a Pipe character.

The first string in a filter is a name to be displayed that describes the filter (e.g. Text Files). The second one specifies the filtering pattern (e.g. *.txt). Therefore a filter for text files would look like this: Text Files or maybe even like this: Text Files (*.txt).

To specify multiple filtering patterns for a single filter, use a semicolon to separate the patterns (e.g. *.txt;*.doc;*.bak). A filtering pattern can be a combination of valid filename characters and an asterisk wildcard character. Do not include spaces in the pattern string.

Several filters are to be delimited also by a Pipe character. Therefore this Open/Save Dialog Filters value should eventually consist of pairs of strings delimited by Pipes. Each pair defines one filter: a name and its filtering pattern.

Default file extension

The Use default file extension, if missing setting specifies whether the Save As dialog should always append a default extension to a file name when no extension is specified by user. The default extension may not exceed 4 characters.

Default extension for plain-text documents is usually txt, but some users may choose to override this and use another value. E.g. Use html, if you creat more HTML documents than simple text files.

Favourites page

See chapter Favourites for any details.

Filters page

See chapter Text Filters for any details.

Settings page

This page offers a place to specify, which categories of options and settings are to be saved upon every exit, so they outlast to the next time, TED Notepad is started.

If none of these categories is ever saved, TED Notepad will always be running with the default or preset values. If these categories are saved only once, directly after configuring TED Notepad to your specific needs, TED Notepad will always start with such desired configuration. See below.

Furthermore, if these categories are saved upon every exit, TED Notepad always starts the same way it was closed for the last time. This is the default behavior.

Note, that these settings are not shared between two running instances of TED Notepad. Therefore, if you change the word wrapping in one window, the other one will remain unchanged. That is usually desired. However, if you add a new favourite in one window, it will not be present immediately in the second window. You will have to save the settings of the first window (e.g. by closing it, which will save all the favourites). Then you will have to re-open the second window, to reload the settings.

Note: To store the settings more portably, see chapter Portable INI file.

Save settings on every exit

The Save settings on every exit option specifies whether any options/settings should be saved at all. Saved options/settings are automatically loaded when TED Notepad is runned next time. If this option is not checked, the settings are not saved upon any exit, therefore, they remain the same as they were before.

If you want the settings never to be saved and never to be loaded, uncheck this option the very first time you run TED Notepad and click the [[Control:Button:Save checked settings:{{{2}}}|{{{2}}}]] button. From now on no other settings will then be saved anymore as well as they have never been before - nothing to load the next time TED Notepad is started.

Note: The technique above will actually save one setting, saying not to save any other settings. To prevent TED Notepad completely from saving any settings, use /nl and /ns command line parameters. See chapter Command line parameters.

If you want to preset the settings once and then have them all the same every time you start TED Notepad, make the changes and then click the [[Control:Button:Save checked settings:{{{2}}}|{{{2}}}]] button. The settings will be saved. Then uncheck this Save settings on exit checkbox and click the [[Control:Button:Save checked settings:{{{2}}}|{{{2}}}]] button again. From now on no new settings will ever be saved.

Save window position

The Save window position specifies whether the main window's position is to be saved. If saved, the next time TED Notepad is started, it will appear on the same position as before. Turning this option on is not recommended much. See notes below for details.

Troubleshooting note: If you are using two displays/monitors, you may simply choose to place TED Notepad on the second display. However, when you disconnect one of those displays later and run TED Notepad, its window will be opened on the missing display and will become quite invisible. It may be quite tricky to move it back into viewable area. Therefore, be careful about this setting. A lot of users already get their window lost this way.

Ludia su proste len ludia! A zensky test funguje stopercentne.. Kazdopadne, s touto featurov vzdy boli (a vzdy budu) nejake nepekne problemy: uzivatelom miznu okna priamo pod rukami.... Kam? ;)

Save window size

The Save window size specifies whether the main window's size is to be saved. If saved, the next time TED Notepad is started, its size will be the same as before. Otherwise, it depends on the system, how big the window will be.

Save basic options

The Save basic options category specifies whether basic options from the Options menu are to be saved. These are the switches that are usually touched a lot according to specific types of documents and/or the type of usage. Especially, the Word Wrap option, the Status Bar visibility option, the Stay on Top and the Fixed-width Font options belong to this category.

Save actual search

The Save actual search category specifies whether the searches are to be saved. There are two searches, the primary one with the Find/Replace dialogs and the secondary one.

Note: The Extended Replace tool is not included within this category, although it is also a searching mechanism.

Save settings

The Save settings category specifies whether the settings from the Settings dialog are to be saved. These are the settings that are usually not modified a lot.

Note: This category actually archs over the saving of nearly all the settings in the Settings dialog. However, note, that Favourites and Filters are treated as separate categories.

Save Filters

The Save Filters category specifies whether the Filters are to be saved. The Filters are saved only when they have been modified.

Save phrases from tools

The Save phrases from tools category specifies whether phrases and also some options from the dialogs of tools are to be saved.

Save Extended Clipboards

The Save Extended Clipboards category specifies whether content of the Extended Clipboards is to be saved. See chapter Clipboards menu for more details about the Extended Clipboards.

Save checked settings

The [[Control:Button:Save checked settings:{{{2}}}|{{{2}}}]] button saves all current settings according to the check boxes above, exactly as they would be saved upon exit.

Note: This button is disabled, if /ns command line parameter takes place. See chapter Command line parameters for more details.

Restore defaults

The [[Control:Button:Restore defaults:{{{2}}}|{{{2}}}]] button restores all options/settings to their default values as if no options/settings were ever loaded and/or modified. Note, that if you restore all options/settings, but choose not to save them, they will not remain restored next time TED Notepad is launched.

Note: There are two options that may not be restored this way: window position and window size.