Difference between revisions of "Ide/IDE Dialogs"

From wiki.visual-prolog.com

Line 239: Line 239:


'''Ctrl-Alt''' switches on/off showing only read-write files.
'''Ctrl-Alt''' switches on/off showing only read-write files.
'''Ctrl-*''' switches on/off alternate filter by letter.

Revision as of 09:26, 26 April 2013

IDE

Warning: These files will be overwritten

When you create a new project with the IDE Project Settings facility, you can specify the Subdirectory in which the project will be placed (notice that usually this name is generated automatically from the specified project name). Notice that each project contains several standard files (always automatically generated by the IDE) with standard names. Therefore, if the specified subdirectory name coincides with one in which a previously created project already exists, then these 2 projects should have several standard files with the same names. Because the old versions of these files can be incompatible with the new project, the Project Settings generates the warning dialog with the title:

These files will be overwritten:

In the central pane of this dialog you see a list of files which should be overwritten.

You can select the following actions:

Continue

If you select this button, then the old versions of files specified in the list will be overwritten with the new versions.

Cancel

If you select this button, then no files will be overwritten, the IDE returns into the Project Settings dialog where you can the specify other name in the Subdirectory control.

Resolve Ambiguity

This dialog appears when you execute the:

  • Go to Declaration (Ctrl+Shift+D),
  • Go to Definition (Ctrl+Shift+C), or
  • Show Visual Prolog Help (F1)

commands and the cursor points onto a "name", which has several versions of the "name" references in the generated browse information and cannot resolve this ambiguity using all additional information about the "name", which The IDE can gather in the edited file.

Correspondently it have titles:

  • Resolve Ambiguity of "name" Declaration
  • Resolve Ambiguity of "name" Definition
  • Choose "name" to Show Help Topic

These dialogs display lists of references to the "name" with additional information (gathered in the generated by the compiler browse information, which helps you to resolve ambiguity of the "name".

Names are prefixed with the same icons, which are used in the Project window.

To continue an initiated command execution you need to select (click) one of displayed lines containing unique references to the "name".

Send Bug Report to Support

Normally you should use Help | Send Bug Report... IDE command to send a bug report or feedback. You can also send a mail directly to the Visual Prolog Support Service.

About Visual Prolog Support Service

Visual Prolog Support is responsible for answering questions only about bugs and problems with using of Visual Prolog language, the IDE, and other tools and packages supplied in Commercial editions of Visual Prolog.

Guidelines for preparing Bug Reports to Visual Prolog Support


1. Please check the following information sources before submitting your E-mail:

2. Please do not ask Visual Prolog Support about general problems like: "Visual Prolog and Fuzzy Logic?"

For things please use Visual Prolog Discussion Forum, where you are free to discuss any question deals with Visual Prolog. Anybody can read the debate, but you need to register if you want to make postings.

Prolog Development Center will follow and participate as much as possible in the debates. But we cannot make any "answer guarantee"; this is mainly your forum.

This forum will receive all major announcements from Prolog Development Center.

3. Your message MUST contain information generated by "Help | Send Bug Report | Show Details" IDE command.

This information contains some parameters about your computer and your project that are useful for correct understanding of the problem. It should be copied to the mail.

4. How to write a message:

  • To:
    The address of Visual Prolog International Support Group is: support@visual-prolog.com
  • Subject:
    Use a short, precise, and relevant Subject (title line). Please, do not use subjects like: My 1st problem with Prolog
  • Message Text:
    One problem per message, please.
    Here you should describe your problem as detailed and precise, as it is possible.
    Please supply examples of code illustrating your problem.
    The information supplied in your message should be sufficient to reproduce your problem on our computers.

Please follow the above guidelines when you E-mail Bug Reports to Visual Prolog Support.

Regards

The Visual Prolog International Support Group

support@visual-prolog.com

Replace Text

Using this dialog you can find and replace each or every occurrence of a text pattern (a string or a regular expression) in the edited file.

Text to Find

In the Text to Find box, type in the search string, or regular expression, or choose a previous string from the drop-down list.

New Text

Type the replacement string, or regular replacement expression in the New Text box, or choose a previous string from the drop-down list. Notice that regular replacement expressions have limited syntax regarding to regular expressions used in the Text to Find patterns.

Origin

Options in the Origin group box defines the file scope in which the string should be searched.
  • Entire Scope
    Defines that the string should be searched in all file.
  • From Cursor
    Defines that the string should be searched beginning from the current cursor position.
  • Selected Text
    Defines that the string should be searched only in the selected piece of the edited text.

Direction

Options in the Direction group box defines the direction in which the string should be searched.
  • Forward
    Search the document below the insertion point.
  • Backward
    Search the document above the insertion point.

Options

In this group box you defines the search options.
  • Case Sensitive
    Find strings having the given pattern of uppercase and lowercase letters.
  • Whole Words Only
    Find occurrences of the string as whole words. It only displays instances of the Find what string that are matched in complete words. For example, a search for "my::List" will return "my::List" but not "cmy::List" or "my::Listtt".
  • Use Regular Expressions
    See [Find_Text_in_Files.htm #Regular_Expressions2 Regular Expressions] for details.

Replace

Press the Replace button to replace the current selection or to invoke searching of the specified string (regular expression) with the specified options if there are no selection.

Find Next

Press the Find button to invoke searching of the next occurrence of the specified string (regular expression) with the specified options.

Change All

Press the Change All button to replace all occurrences of the search text, in the specified scope.

Close

Close this dialog.

Help

Displays this help topic.

Find Text in Files

Using this dialog you can find each occurrence of a combination of any characters, including uppercase and lowercase characters, whole words, or parts of words, or regular expressions in the specified group of files.

Ide FindInFiles.png

Text to Find

In the Text to Find box, type in the search string, or regular expression, or choose a previous string from the drop-down list.

Find in All Opened Editors

Check this option if you wish that the IDE search the specified string only in that text files, which are currently opened in the IDE text editors.

Find in Project Files Only

Check this option if you wish that the IDE search the specified string only in text files, which are parts of the project currently loaded into the IDE.
This button is disabled when the project is not loaded.

Show Search Results in New Window

If this option is checked ON, then the IDE will open new Search results window each time the search is completed, otherwise it will display search results in the same window.

In Files:

In this list editor you can specify (or select from the list of previously used) the file mask which will be used to restrict files in which the IDE will search for the string. For example, you can use * operator to specify that any sub-string can be used instead of this operator.
This option is disabled when the Find in All Opened Editors option is checked ON.

In Folder:

In this list editor you can specify (or select from the list of previously used) the folder, which will be used to restrict files in which the IDE will search for the string.
This option is disabled when the Find in All Opened Editors option is checked ON.

Browse

Press this button to open the Set New Directory dialog in which you can select the folder, which name will be inserted into the In Folder field.

Notice that when Find in Project Files Only is checked ON, then this dialog will gives you access only to the folders known to the project.
This button is disabled when the Find in All Opened Editors option is checked ON.

Search Subfolders

When this option is checked ON (the default), then the IDE will search in all subfolders of the folder specified in the In Folder field.
Otherwise, search will be only in the files directly in the folder specified in the In Folder field.

Whole Words Only

Find occurrences of the string as whole words. It only displays instances of the Find what string that are matched in complete words. For example, a search for "my::List" will return "my::List" but not "cmy::List" or "my::Listtt".

Case Sensitive

The selected item specifies whether the search should match case of the whole search string (Case Sensitive), ignore the case (Case Insensitive) or match the case of the first character of the search string (Prolog Sensitive). The last option is unavailable, when Regular Expressions option is checked ON.

Regular Expressions

Provides possibility to perform advanced string searching operations (searching, matching and replacing) using regular expressions.

Regular Expressions

A regular expression (or pattern) is a text string that describes some (mathematical) group of strings. A string S "matches" a regular expression R if S belongs to the set of strings described by R. Using regular expression, you can:
  • check whether the specified string matches the specified pattern;
  • search within a string for a substring matching the specified pattern;
  • perform replacing within matched substrings.
Some regular expressions can match only one substring. That is, a set of strings such regular expression describes has only one member. For example, the regular expression foo matches only the substring foo and no others. Other regular expressions can match more than one substring. That is, a set of strings such regular expression describes has more than one member. For example, the regular expression f* matches the set of strings made up of any number (including zero) of f characters. Some characters in regular expressions match themselves (such as f) and some do not match to any concrete character (such as *). Characters that do not match themselves are used to specify patterns, which describe sets of different strings.

Regular Expression Syntax See the [pfc\regEx\packRegEx.htm regEx] package for more details of regular expression syntax.

Find

Press the Find button to invoke searching of the specified string (regular expression) with the specified options.

Stop

Press the Stop button to stop searching.

Help

Displays this help topic.

Search results

Ide FindInFilesResults.png

This window displays the table which contains the names of files in which the specified string is found, the line number and the position, where the specified text is located and the content of the whole line.

If you double-click any filename, then this file will be opened in the text editor.

Find Text

Using this dialog you can find each occurrence of a combination of any characters, including uppercase and lowercase characters, whole words, or parts of words, or regular expressions.

Text to Find

In the Text to Find box, type in the search string, or regular expression, or choose a previous string from the drop-down list.

Origin

Options in the Origin group box defines the file scope in which the string should be searched.
Entire Scope
Defines that the string should be searched in all file.
From Cursor
Defines that the string should be searched beginning from the current cursor position.
Selected Text
Defines that the string should be searched only in the selected piece of the edited text.

Direction

Options in the Direction group box defines the direction in which the string should be searched.
Forward
Search the document below the insertion point.
Backward
Search the document above the insertion point.

Options

In this group box you defines the search options.
Case Sensitive
Find strings having the given pattern of uppercase and lowercase letters.
Whole Words Only
Find occurrences of the string as whole words.
Use Regular Expressions
See [Find_Text_in_Files.htm #Regular_Expressions2 Regular Expressions] for details.

Find

Press the Find button to invoke searching of the specified string (regular expression) with the specified options.

Close

Close this dialog.

Help

Displays this help topic.

Window Navigation Dialog

The order, in which Ctrl-TAB shifts between IDE windows, has been changed to visit most-recently-visited windows first.

Furthermore, Ctrl-TAB also brings up a navigation dialog listing all the open windows. The dialog stays up as long as Ctrl-key is pressed. In this dialog you can see the windows in the order they will be shifted to, but you can also choose a window directly using the mouse or the arrow keys. If you press letters the list will be filtered to windows starting with the letters you have pressed.

Ctrl-F1 Help,

Ctrl-Del will close the selected window,

Ctrl-BackSpace removes the last letter,

Ctrl-Alt switches on/off showing only read-write files.

Ctrl-* switches on/off alternate filter by letter.