Отображает результаты поиска ссылок кода, которые отвечают условиям поиска в области проект/каталог и типам файлов, определенных в диалоговом окне Look Up Reference (Поиск ссылки). Для получения более подробной информации смотрите описание Диалоговое окно Look Up Reference (Поиск ссылки).

NoteЗамечание

На сайте российского FoxClub доступна локализованная, русскоязычная версия Code References

Окно Code References (Ссылки кода) появляется после того, как вы произвели поиск с помощью диалогового окна Look Up Reference (Поиск ссылки) или когда вы выбираете Code References (Ссылки кода) из меню Tools (Инструменты), когда вы желаете поискать среди раннее найденных ссылок в коде в том же самом проекте или каталоге. Текущий активный проект всегда имеет преимущество над областью поиска "Каталог". Если диалоговое окно Look Up Reference (Поиск ссылки) было ранее открыто, вы можете, кроме того, вызвать окно Code References (Ссылки кода) с помощью приведенной ниже строки кода:

 CopyCode imageСкопировать код
DO (_FOXREF)

Вы можете обеспечить постоянную видимость окна Code References (Ссылки кода) поверх других окон, когда эти окна активны. Для этого в окне Code References (Ссылки кода) выполните щелчок по правой клавише мыши справа от полоски инструментов и выберите Always On Top.

Однако, если вы выбрали "Always on Top" для других окон Visual FoxPro, вы не увидите различия в поведении окна.

В окне Code References (Ссылки кода) доступны перечисленные ниже командные кнопки. Вы можете найти некоторые из команд, связанных с этими кнопками в контекстных меню, доступных в разных панелях окна Code Reference (Ссылки кода).

Открыть - кнопка с иконкой каталога

Открывает или выводит поверх других окон конструктор для выбранного файла. Команда Open (Открыть) доступна только в том случае, если выбран узел файла.

Кнопка с изображением направленной вниз стрелки

Служит для переключения между областями поиска "Проект/Каталог".

Search (Поиск)

Отображает диалоговое окно Look Up Reference (Поиск ссылки) для производства нового поиска ссылок.

Refresh (Обновить)

Обновляет ранее полученные результаты поиска текущими результатами.

Replace (Заменить)

Отображает диалоговое окно Replace (Заменить) для указания выражения замещения ссылки кода, выбранной в панели результатов. В диалоговом окне Replace (Заменить) доступны перечисленные ниже опции:

  • Replace with (Заменить на)   указывает выражение, которое заменить выбранное выражение ссылки кода или ссылок.

  • Confirm replacements (Подтверждать замещения)  Открывает диалоговое окно в котором вы можете либо подтвердить, отклонить или отменить операцию замещения для каждой ссылки кода.

  • Preserve case (Сохранить регистр)  Производит операции замещения, используя оригинальное использование верхнего или нижнего регистра символов ссылки кода или замещаемого текста. Сохранение регистра текста включает в себя только верхний и нижний регистры и титульный регистр, в котором все первые символы слов выводятся в верхнем регистре (заглавными букавами). Эта опция не поддерживает смещанное использование регистров, такое как "FoxPro", поскольку длины оригинального и замещающих значений могут отличаться.

  • Create backup of modified files (Создать резервную копию изменяемых файлов)  Создает резервную копию выбранных файлов до производства операции замещения. Резервная копия хранится в том же самом месте, где и оригинальный файл. Вы можете открыть диалоговое окно You can open the Options (Параметры) из окна Code References (Ссылки кода) или из диалогового окна Look Up Reference (Поиск ссылки), где можете выбрать соглашение по наименованию файлов резервных копий.

Visual FoxPro создает журнал регистрации, содержащтй результаты произведенных самыми последними операций замешений индивидуальной ссылки кода. Эти записи регистрации показываются ниже узла Replacement Logs (Регистрации замещения) в панели поиска. Каждая запись регистрации содержит перечисленные ниже элементы:

  • Строку, в которой отображены оригинальное и замещаемое значения

  • Отметку о результате операции замещения - была ли она удачной или была ли ссылка пропущена при использовании опции Confirm Replacements (Подверждать замещения)

  • Details and code for you to make data structure changes if data files might be affected

    NoteЗамечание

    Операции поиска и замещения могут включать в свою область воздействия все файлы Visual FoxPro, включая файлы данных. В результате этого, операции, производяющие замену могут изменить структуру данных.

    NoteЗамечание

    Когда используется такая возможность, Visual FoxPro показывает диалоговое окно, запрашивающее вас подтвердить или отклонить операцию замещения. Если вы подтверждаете операцию замещения, Visual FoxPro производить только те замещения, которые не затрагивают файлы данных и предоставляет код в узле строки поиска под узлом Replacement Logs (Регистрация замещений) для того, чтобы вы могли произвести желаемые изменения вручную. Если вы отклоните замещение, то изменения не будут произведены.

    NoteЗамечание

    В дополнение к сказанному, инструмент Code Reference (Ссылки кода) не поддерживает замещение имен свойств или методов в файлах форм (.scx) или библиотек визуальных классов (.vcx), вследствие возможных изменений в субклассах и устаревания ссылок.

Print (Печать)

Отображает диалоговое окно Print для выбора набора ссылок код из результата поиска для их печати. В диалоговом окне Print доступны перечисленные ниже опции:

  • Search set (набор результата)   указывает на все результы поиска или на набор результатов, который вы желаете отпечатать.

  • All (все)   Определяет, что все ссылки в выбранном наборе ссылок кода должны быть отпечатаны.

  • Selected items only (только выбранные элементы)   Определяет, что должны быть отпечатаны только выбранные элементы набора результатов.

  • Print (печать)   Печатает указанный набор ссылок кода.

  • Preview (предпросмотр)   Открывает диалоговое окно Print Preview (Предварительный просмотр печати) и конструктор отчета, чтобы вы смогли предварительно до печати просмотреть ссылки кода, которые будут печататься.

Вы можете указать, если желаете, другой отчет изменением перечисленных ниже полей в файле RefAddin.dbf:

  • Type   определяет Report.

  • Data   определяет описание отчета.

  • Filename   определяет имя файла отчета, такое как "report1.frx".

Export

Отображает диалоговое окно Export (Экпорт) для экспорта всех или набора ссылок кода из результата поиска в различные форматы. В диалоговом окне Export (Экспорт) доступны перечисленные ниже опции:

  • Type (Тип)  указывает тип файла, в который будут экпортироваться ваши результаты поиска. Для того, чтобы опция XML Output Options была доступной, выберите Extensible Markup Language (XML) в выпадающем списке Type (Тип).

    При экспорте результатов вашего поиска в HTML, Visual FoxPro генерирует файл с помощью XML и XSLT. По умолчанию, Visual FoxPro ищет файл FoxRef.xsl в своем домашнем каталоге или каталоге, на который указывает HOME(0). Если файл не найден, Visual FoxPro копирует внешний файл .xsl и помещает его в каталог Visual FoxPro User Application Data или в каталог, указываемый HOME(7), если вы не укажите какой-то другой. Вы можете предоставить файл преобразования XSLT для форматирования файла HTML, переименовав ваш XSLT файл в FoxRef.xsl и заменив оригинальный .xsl файл новым файлом.

  • To (Экспорт в)  указывает имя для файл, в который будет производиться экспорт. Для выбора размещения, отличного от текущего каталога, щелкните по кнопке поиска (...).

  • Search set (Набор поиска) определяет - что вы желаете экспортировать - все результаты поиска или набор результатов.

  • View after export (вывести для просмотра после экспорта)  определяет, что вы увидите сгенерированный результат после завершения операции экспорта. Эта опция становится недоступной, когда в качестве направления экспорта вы выберите Clipboard (Буфер обмена).

  • XML Output Options (Параметры вывода XML)  В этой области формы определяются приведенные ниже дополнительные опции для экспорта результатов в XML:

    Generate element-based XML (Генерировать element-based XML)  Генерирует XML файл, в котором поля сохраняются в виде элементов.

    Generate attribute-based XML (Генерировать attribute-based XML)   Генерирует XML файл, в котором поля сохраняются в виде атрибутов.

    Include schema (Включить в XML файл схему) Добавляет схему стандарта XML Schema Definition (XSD) в файл XML.

  • All   Определяет, что должны быть экспортированы все ссылки в выбранном наборе.

  • Selected items only   Определяет, что должны быть экспортированы только выбранные из набора ссылки.

Options (Параметры)

Открывает диалоговое окно Options (Параметры) для установки дополнительный опций вашего поиска. Для получения более подробной информации смотрите Диалоговое окно Options (Параметры) диалогового окна Look Up Reference (Поиск ссылки).

Help (Помощь)

Открывает поставляемый с Visual FoxPro файл справки.

Панель поиска

Панель поиска, или левое верхнее окно, содержит дерево результатов из поиска ссылки кода. Дерево отображает узел All Results (Все результаты), каждую ссылку кода и файл, который содержит ссылку. Когда вы щелкните по имени файла, обзор ссылок в панели результатов, или правом верхнем окне, отфильтрует для отображения только те результаты, которые связаны с этим конкретным файлом.

Узел Replacement Logs (Регистрации замещений) появится в панели поиска, когда журнал регистрации будет содержать самые последние результаты созданных операцией замещения индивидуальных ссылок кода.

В контекстном меню панели доступны перечисленные ниже дополнительные команды; меню вызывается при щелчке по правой клавише на ссылке кода или узле файла внутри панели поиска:

Copy (Копировать)

Копирует всю информацию в панели поиска, включая имя файла, класс, метод или процедуру, а также информацию строки, для выбранного элемента в буфер обмена, чтобы вы в дальнейшем могли вставить его там, где это вам потребуется.

Развернуть все

Полностью разворачивает дерево результатов поиска.

Свернуть все

Сворачивает дерево результатов поиска.

Sort by Most Recent First (Сортировать сначала по самым последним использованным)

Сортирует в дереве результаты поиска, помещая самые последние на вершину дерева.

Clear Result (Очистить результат)

Удаляет выбранный результат поиска из панели. Команда Clear Result (Очистить результат) недоступна, если выбран узел All Results (Все результаты). Если выбран файл, то только этот файл удаляется из панели поиска.

Clear All Results (Очистить все результаты)

Удаляет все результаты из панели поиска.

Refresh (Обновить) обновляет результаты поиска

Панель результатов

Панель результатов, или верхнее окно справа, отображает результаты поиска ссылок в коде, включая потенциальные определения, если они существуют, к которым вы можете быстро перейти, а также множественные ссылки, которые могут встретиться в одной строке кода. Если последние существуют, то в панели результатов на этой строке отображается индикатор (число ссылок, заключенное в кружок).

В панели результатов отображаются перечисленные ниже элементы:

  • Чек-боксы для выбора индивидуальных строк результатов

  • #   Числоа ссылок, которые встретились в результатах, если найдено больше одной

  • File Name (Имя файла)  Имя файла и его размещение

  • Class.Method, Line (Класс.Метод, строка)   Класс, метод и номер строки

  • Code (Код)  Строка кода, которая содержит искомую ссылку

Вы можете отсортировать элементы в каждой колонке, щелкнув по ее заголовку.

В контекстном меню панели результатов, которое появляется при щелчке по правой клавише мыши на выбранной ссылке, доступны дополнительные, перечисленные ниже команды:

Copy (Скопировать)

Копирует всю информацию для выбранной строки, включая имя файла, класс, метод или процедуру и информацию о строке, в буфер обмена, которую вы затем можете вставить там, где вам потребуется.

Select All (Выбрать все)

Выбирает все элементы в панели результатов.

Clear Selections (Очистить выборки)

Снимает метки со всех чек-боксов полученных результатов поиска.

Sort by (Сортировать по)

Организует элементы в следующих порядках:

  • File Name (имени файла)   сортирует элементы на основе имени файла.

  • Class.Method (классу.методу)   сортирует элементы на основе имени класса и именем метода.

  • Selected (выбранным)   группирует элементы по выбранным.

  • File Type (типу файла)   сортирует элементы на основе типов файлов (по расширению).

  • Location (размещению)   сортирует элементы по местонахождению каталога.

Панель описания

Панель описания, или нижнее окно, отображает информацию о поиске ссылки кода, такую, как область поиска - каталонг или проект, в которых производился поиск и найденные при поиске соответствия. Когда выбрага ссылка, то панель описания показывает местонахождение ссылки и строку кода, в которой появилось искомое выражение.

Для скрытия или отображения панели описания

  1. В окне Code References (Ссылки кода) выполните щелчок по правой клавише мыши в области справа от полоски инструментов.

  2. Из контекстного меню выберите Display Descriptions (Отобразить описания).

Смотрите также