Работа с языком запросов
Altium Essentials: PCB Global Editing and List Panel
This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.
Краткий обзор
- Узнайте, как запросы позволяют находить определённые объекты и как область действия фильтра определяет, в каких документах и среди каких объектов выполняется поиск.
- Научитесь создавать и проверять выражения запросов, а затем управлять выделением, масштабированием и маскированием результатов.
- Разберитесь, как применять и сбрасывать фильтры, повторно использовать избранные и недавние запросы, а также расставлять скобки, чтобы сделать выражения понятнее.
Что такое запрос?
Пожалуй, самая сложная задача при работе над сложным электронным проектом — управление большим количеством объектов проекта. От компонентов, меток цепей и текстовых строк на листах схемы до сотен компонентов и дорожек, образующих трассировку печатной платы, — ко всем этим объектам необходимо иметь доступ для просмотра и редактирования. Как и в большинстве приложений Windows, можно дважды щелкнуть объект и изменить его свойства. Это удобно для одного объекта, но вряд ли подойдет, если нужно отредактировать более 300 строк позиционных обозначений компонентов или изменить все переходные отверстия на плате. Для таких изменений необходим одновременный доступ к нескольким объектам.
В основе редакторов схем и печатных плат Altium Designer лежит мощный механизм запросов. Вводя запросы, можно с помощью фильтрации находить и редактировать именно те объекты, которые вам нужны.
Мощная система фильтрации и редактирования данных в Altium Designer позволяет указать программе, какой набор объектов требуется получить. Такое указание вводится в виде запроса. Запрос — это строка, составленная с использованием определенных ключевых слов и синтаксиса, которая возвращает нужные объекты. Что делать с этими объектами дальше, решать вам. Например, можно подсветить их и приглушить все остальные объекты, а можно просмотреть или отсортировать их свойства и изменить определенные общие для них атрибуты.
Запросы можно применять в разных местах, но основным центром управления служат Filter панели, показанные на изображениях ниже. Нажмите F12, чтобы отобразить или скрыть панель Filter .
Панели PCB Filter и SCH Filter с запросами

Панели PCBLIB Filter и SCHLIB Filter с запросами
Элементы управления на панели позволяют задать, к каким объектам будет применяться запрос и как обрабатывать объекты, соответствующие и не соответствующие запросу.
Панель SCH Filter

Быстро находите и подсвечивайте объекты с помощью логических запросов на панели SCH Filter.
Общие сведения
Панель SCH Filter позволяет создавать фильтры на основе логических запросов. Заданный фильтр можно применить к активному документу схемы или ко всем открытым документам схем, чтобы точнее и эффективнее выбирать и редактировать несколько объектов.
Доступ к панели
Открыть панель можно следующими способами:
- Когда активен редактор схем, нажмите кнопку Панели в правом нижнем углу редактора, затем выберите SCH Filter во всплывающем меню.
- Нажмите View » Panels » SCH Filter.
- Используйте сочетание клавиш F12.
Определение области действия фильтра
В первой области панели расположены элементы управления для определения области действия фильтра:
В области Limit search to находятся элементы управления для дополнительного уточнения области действия фильтра:
- All Objects — применять фильтр ко всем объектам проекта.
- Selected Objects — применять фильтр только к выбранным в данный момент объектам проекта.
- Non Selected Objects — применять фильтр только к объектам проекта, которые в данный момент не выбраны.
Раскрывающийся список Consider objects in позволяет указать, где будет применяться фильтр. Доступны следующие варианты:
- Current Document — применять фильтрацию только к активному документу схемы (по умолчанию).
- Open Documents — применять фильтрацию ко всем открытым документам схем.
- Project Documents — применять фильтрацию ко всем открытым документам схем, которые являются исходными документами одного и того же родительского проекта.
Определение запросов фильтра
Центральная область панели позволяет создавать фильтры путем ввода логических запросов. Запрос можно ввести непосредственно в поле. По мере ввода будет появляться список подсказок с возможными ключевыми словами.
Для помощи в создании запросов доступен помощник Query Helper. Эта функция особенно полезна, если вы не уверены в синтаксисе запроса или в том, какие ключевые слова можно использовать. Чтобы воспользоваться помощником, нажмите кнопку Helper — откроется диалоговое окно Помощник по запросам. Механизм запросов анализирует документ и формирует список всех доступных объектов, а также общих ключевых слов для использования в запросах.
Составьте выражение запроса в верхней части диалогового окна, используя доступные SCH Functions и System Functions. В средней части окна представлен набор операторов для построения выражения. Нажмите кнопку Check Syntax, чтобы проверить синтаксическую корректность выражения.
Когда нужное выражение запроса будет задано, нажмите OK, чтобы загрузить запрос в центральную область панели SCH Filter и подготовить фильтр к применению.
Настройка подсветки результатов фильтрации
Перед применением запроса рекомендуется определить, как результаты фильтрации должны отображаться в рабочей области проекта. Области Objects passing/not passing the filter панели содержат различные параметры, которые в совокупности управляют подсветкой при постоянной фильтрации.
Параметры в области Objects passing the filter позволяют управлять отображением в рабочей области всех объектов, которые входят в область действия фильтра и соответствуют его выражению запроса:
- Select — если этот параметр включен (по умолчанию), отфильтрованные объекты будут выбраны в рабочей области.
- Zoom — если этот параметр включен (по умолчанию), масштаб и положение вида в окне редактора проекта будут изменены так, чтобы отфильтрованные объекты отображались крупнее и по центру (если это возможно).
Параметры в области Objects not passing the filter позволяют управлять отображением в рабочей области всех объектов, которые не входят в область действия фильтра и/или не соответствуют его выражению запроса:
- Deselect — если этот параметр включен (по умолчанию), со всех объектов, не входящих в область действия фильтра, будет снят выбор в рабочей области.
- Mask out — если этот параметр включен (по умолчанию), отфильтрованные объекты будут отображаться в окне редактора проекта без приглушения, а все остальные объекты будут приглушены. При применении маскирования все объекты вне области действия фильтра будут недоступны для выбора и редактирования.
Эти параметры можно включать в любом сочетании. Например, можно увеличить масштаб отображения всех отфильтрованных объектов, соответствующих запросу, расположить их по центру и выбрать в окне редактора проекта, а также применить маскирование, чтобы остальные объекты проекта не мешали работе.
Применение и сброс фильтра
После того как запрос задан, а параметры панели настроены нужным образом, можно применить фильтр: нажмите кнопку Apply или клавишу Enter.
Чтобы сбросить текущий фильтр из панели, удалите выражение запроса в панели, затем нажмите кнопку Apply или клавишу Enter. Все объекты в рабочей области проекта станут полностью видимыми и доступными для выбора и редактирования.
Контекстные меню
Щелчок правой кнопкой мыши внутри панели SCH Filter открывает контекстное меню с дополнительными параметрами и командами.
Меню содержит следующие команды:
- Add to Favorites — добавить выражение запроса, отображаемое в панели, в список избранных запросов. Запрос появится в виде новой записи на вкладке Favorites диалогового окна Диспетчер выражений. После добавления запроса в список избранных он отображается в верхней части контекстного меню. В меню отображаются десять последних запросов, добавленных в избранное (самый новый — вверху), что позволяет быстро находить и повторно использовать избранные выражения запросов.
- Organize Favorites — открыть вкладку Favorites диалогового окна Диспетчер выражений, на которой можно упорядочивать записи в списке избранных запросов: переименовывать и удалять их.
- Examples — нажмите, чтобы открыть подменю с готовыми примерами фильтров. При выборе примера соответствующее выражение запроса загружается в центральную область панели.
- History — нажмите, чтобы открыть подменю с девятью последними использованными выражениями запросов из истории запросов панели. Выберите пункт More, чтобы открыть вкладку History диалогового окна Диспетчер выражений, где можно просмотреть полный список ранее использованных запросов, применить нужный запрос, а также при необходимости очистить историю.
- Show Scope Options — показать или скрыть область настройки области действия фильтра на панели.
- Show Masking Options — показать или скрыть область настройки подсветки результатов фильтрации на панели.
Примечания
Общие сведения
- Нажатие клавиши F12 показывает или скрывает панель в рабочей области.
- При составлении запроса в диалоговом окне Помощник запросов щелкните внутри введенного ключевого слова или по ключевому слову в одном из доступных списков и нажмите F1, чтобы открыть справку по этому ключевому слову. Аналогично можно открыть справку по ключевому слову, щелкнув внутри него в центральной области панели SCH Filter и нажав F1.
- В зависимости от формы и размера панели ее содержимое автоматически располагается по горизонтали или по вертикали.
При составлении выражений запросов
- Настоятельно рекомендуется использовать скобки во всех случаях, когда есть хоть малейшая вероятность неверной интерпретации запроса.
-
Скобки имеют наивысший приоритет в порядке выполнения операторов, который определяет, как программа интерпретирует запросы, если скобки не заданы. Порядок приоритетов следующий:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Этот порядок приоритетов аналогичен используемому в языках типа Pascal; активное использование скобок устраняет неоднозначность и облегчает чтение запросов другими пользователями. - Неоднозначности разрешаются слева направо.
- Выражения в скобках вычисляются от внутренних к внешним, а на одном уровне вложенности — слева направо.
- Поскольку параметры отображения объектов, соответствующих и не соответствующих примененному фильтру, задаются отдельно, можно применять новые запросы фильтрации к результатам предыдущей фильтрации.
- Фильтрация с помощью запросов из панели SCH Filter сохраняется до явного сброса. При маскировании объектов проекта, не соответствующих фильтру, степень маскирования регулируется ползунком в нижней части панели.
- Чтобы сбросить такой фильтр, необходимо применить пустой запрос из панели SCH Filter.
Панель фильтра SCHLIB
Быстро находите и выделяйте объекты библиотеки схемных символов с помощью логических запросов в панели SCHLIB Filter.
Обзор
Панель SCHLIB Filter позволяет создавать фильтры с помощью логических запросов. Заданный фильтр можно применить к активному компоненту библиотеки схемных символов или ко всем компонентам активной библиотеки, что позволяет точнее и эффективнее выбирать и редактировать несколько объектов одновременно. Отображение объектов можно настроить отдельно для объектов, соответствующих критериям поиска фильтра, и для объектов, не соответствующих им.
Доступ к панели
Открыть панель можно следующими способами:
- Нажмите кнопку Панели в правом нижнем углу рабочей области, затем выберите SCHLIB Filter.
- Выберите View » Panels » SCHLIB Filter в главном меню.
- Используйте сочетание клавиш F12.
Настройка области действия фильтра
В левой части панели SCHLIB Filter находятся элементы управления для задания (ограничения) области действия фильтра.
Доступны следующие параметры области действия:
- All Objects — применить фильтр ко всем объектам проекта.
- Selected Objects — применить фильтр только к выбранным в данный момент объектам проекта.
- Non Selected Objects — применить фильтр только к объектам проекта, которые в данный момент не выбраны.
- Whole Library — определяет, применяется ли фильтрация только к активному компоненту (параметр отключен) или ко всем компонентам в активном документе библиотеки схемных символов (параметр включен).
Создание запросов фильтрации
Центральная область панели SCHLIB Filter позволяет создавать фильтры путем ввода логических запросов.
Запрос можно ввести непосредственно в поле. По мере ввода будет появляться список подсказок с возможными ключевыми словами.
Помощник запросов
Помимо списка подсказок, панель также предлагает средство Query Helper, помогающее создавать запросы. Оно особенно полезно, если вы не уверены в синтаксисе запроса или в том, какие ключевые слова можно использовать. Чтобы воспользоваться Query Helper, нажмите кнопку Helper для открытия диалогового окна Query Helper. Механизм обработки запросов анализирует документ и выводит список всех доступных объектов, а также общие ключевые слова для использования в запросах.
В верхней части диалогового окна составьте выражение запроса с помощью доступных SCH Functions и System Functions. В средней части диалогового окна представлены операторы для построения выражения. Нажмите кнопку Check Syntax, чтобы проверить синтаксическую корректность выражения.
Задав нужное выражение запроса, нажмите OK, чтобы загрузить запрос в центральную область панели SCHLIB Filter. Примените фильтр с помощью кнопки Apply.
При применении ко всей библиотеке выводы, удовлетворяющие условиям фильтра, будут подсвечены и у всех остальных компонентов.
Подробнее о применении фильтров см. в разделе Applying and Clearing a Filter ниже.
Настройка подсветки при фильтрации
Перед применением запроса в панели SCHLIB Filter рекомендуется настроить отображение результатов фильтрации в рабочей области редактора. В правой части панели расположены параметры, которые вместе образуют набор средств управления подсветкой при постоянной фильтрации.
Параметры Objects passing the filter позволяют управлять отображением в рабочей области всех объектов, которые входят в область действия фильтра и соответствуют заданному выражению запроса.
- Select — если включено (по умолчанию), отфильтрованные объекты выделяются в рабочей области.
- Zoom — если включено (по умолчанию), отфильтрованные объекты масштабируются и центрируются (по возможности) в окне редактора библиотек. Поведение при масштабировании определяется параметрами Zoom Library Components, заданными на странице Schematic - Library AutoZoom диалогового окна Preferences.
Напротив, параметры Objects not passing the filter позволяют управлять отображением в рабочей области всех объектов, которые do not входят в область действия фильтра и/или соответствуют заданному выражению запроса.
- Deselect — если включено (по умолчанию), со всех объектов вне области действия фильтра снимается выделение в рабочей области.
- Mask out — если включено (по умолчанию), все объекты вне области действия фильтра маскируются в окне редактора библиотек. Уровень маскирования задается ползунком.
Применение и сброс фильтра
После того как вы задали запрос и настроили необходимые параметры панели, примените фильтр, нажав кнопку Apply на панели или клавишу Enter.
Чтобы сбросить текущий фильтр из панели, очистите выражение запроса в центральной области панели (выделите и удалите его), затем нажмите кнопку Apply или клавишу Enter. Все объекты в рабочей области проекта снова станут полностью видимыми и доступными для выделения и редактирования.
Чтобы сбросить фильтрацию в рабочей области, сохранив выражение запроса в центральной области панели, используйте кнопку Clear Current Filter на панели инструментов Sch Lib Standard (сочетание клавиш Shift+C).
Контекстное меню
Щелчок правой кнопкой мыши в панели SCHLIB Filter открывает контекстное меню с дополнительными параметрами и командами.
В меню доступны следующие команды:
- Add to Favorites — добавляет выражение запроса, отображаемое в центральной области панели, в список избранных запросов. Запрос появится в виде новой записи на вкладке Favorites диалогового окна Expression Manager. При добавлении запроса в избранное он также появляется в верхней части контекстного меню. В меню отображаются десять последних добавленных в избранное запросов (самый новый — сверху), что позволяет быстро находить и повторно использовать избранные выражения запросов.
- Organize Favorites — открывает вкладку Favorites диалогового окна Expression Manager, на которой можно упорядочивать записи в списке избранных запросов: переименовывать и удалять их.
- Examples — открывает подменю с готовыми примерами фильтров. При выборе примера соответствующее выражение запроса загружается в центральную область панели.
- History — открывает подменю с девятью последними использованными выражениями запросов из истории запросов панели. Выберите пункт More, чтобы открыть вкладку History диалогового окна Expression Manager, где можно просмотреть полный список ранее использованных запросов, применить нужный запрос, а также при необходимости очистить историю.
- Show Scope Options — показывает или скрывает область настройки области действия фильтра на панели.
- Show Masking Options — показывает или скрывает область настройки подсветки при фильтрации на панели.
Примечания
Общие сведения
- Нажатие клавиши F12 показывает или скрывает панель в рабочей области.
- Фильтрация с помощью запросов из панели SCHLIB Filter сохраняется в течение сеанса. Постоянный фильтр необходимо сбросить соответствующим действием Clear (применением пустого запроса из панели SCHLIB Filter).
- В зависимости от формы и размера самой панели SCHLIB Filter ее содержимое динамически располагается по горизонтали или по вертикали.
Построение выражений запросов
- Настоятельно рекомендуется использовать скобки во всех случаях, когда существует вероятность неправильной интерпретации запроса.
-
Скобки имеют наивысший приоритет в порядке выполнения операций, заданном для доступных операторов. Этот порядок определяет, как программа интерпретирует запросы, если пользователь не указал скобки. Порядок приоритетов следующий:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Этот порядок приоритетов аналогичен используемому в языках типа Pascal. Однако широкое использование скобок устраняет неоднозначность и облегчает чтение запросов другими пользователями. - Неоднозначности разрешаются при обработке слева направо.
- Выражения в скобках вычисляются от внутренних к внешним, а на одном уровне вложенности — слева направо.
Панель PCB Filter

Панель PCB Filter
Обзор
Панель PCB Filter содержит элементы управления для создания фильтров с помощью логических запросов. Заданный фильтр можно применить к активной печатной плате, что позволяет точно и эффективно выбирать и редактировать множество объектов.
Доступ к панели
Открыть панель в редакторе печатных плат можно следующими способами:
- Нажмите кнопку Panels в правом нижнем углу рабочей области, затем выберите PCB Filter.
- Выберите View » Panels » PCB Filter в главном меню.
- Используйте сочетание клавиш F12 .
Разделы панели
Панель PCB Filter состоит из трех областей. Первые две — это списки с возможностью выбора, которые совместно определяют область действия фильтра: Object и Layer.
В третьей области, Filter, отображается запрос, сформированный на основе выбранных объектов и слоев.
Создание простых выражений фильтра
Основная область панели содержит элементы управления для быстрого создания простых выражений фильтра для любых сочетаний объектов. Типы объектов представлены в виде «матрицы объектов» и разделены на объекты цепей (Net), объекты компонентов (Comp) и свободные объекты (Free). Следующий основной набор объектов повторяется во всех трех группах:
- Дорожка
- Дуга
- Переходное отверстие
- Контактная площадка
- Заливка
- Область
Объект Text доступен в группах Comp и Free , однако, поскольку этот тип объектов не связан с цепями, он не входит в группу Net . Кроме того, группа Free также включает: Component, Component Body, Room и Polygon.
Например, если выбрать значения «Component» и «Top Layer», на виде платы будут подсвечены компоненты верхнего слоя. Выбор в обоих разделах панели определяет совокупный результат нескольких этапов фильтрации, что позволяет быстро подсветить объекты проекта любого типа.
Чтобы использовать объект при создании выражения фильтра, то есть фильтровать по этому объекту, установите соответствующий флажок в матрице объектов. Команды контекстного меню этой области позволяют быстро установить или снять все флажки в матрице либо инвертировать их состояние.
Используйте область Layer панели, чтобы ограничить действие фильтра определенным слоем, несколькими слоями или определенным классом слоев. В списке представлены:
-
Заданные для платы классы слоев, среди которых по умолчанию:
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- Слои, заданные в стеке слоев (как они представлены в редакторе стека слоев).
- Верхний и нижний слои паяльной пасты.
По мере выбора параметров фильтрации результирующее выражение запроса формируется динамически и отображается в области Filter панели. После того как выражение запроса фильтра задано, его необходимо применить отдельным действием. Для этого нажмите кнопку Apply to All в нижней части панели. Если фильтр требуется применить только к объектам, выбранным в рабочей области, нажмите кнопку Apply to Selected.
Фильтрация по объектам
Выбор в списке Object панели фильтрует вид платы, отображая примитивы проекта. Все объекты будут подсвечены, если это не изменено настройками в списках фильтрации Object и/или Layer .

Плата при выбранных значениях Component Body и Pad (In Any Component) в разделе Object. Для Layer установлено значение <All>.

Плата при выбранных для Object значениях Tracks (In Any Net) и Pads (In Any Net). Для Layer установлено значение <All>.
Фильтрация по слоям
Выбор в списке Layer панели фильтрует вид платы, отображая объекты на указанном физическом слое проекта (сигнальном слое, слое маски или шелкографии). Все соответствующие объекты слоя будут подсвечены, если это не изменено настройками в списках фильтрации Layer и/или Objects .

Плата при выбранных для Object значениях Components и Pads (In Any Component). Для Layers установлено значение Top Layer.

Плата при установленном для Object значении Tracks (In Any Net). Для Layer установлено значение Bottom Layer.
Выбор отфильтрованных объектов
Совместное действие фильтров панели помогает как просматривать, так и выбирать интересующие объекты проекта платы.
Выбирать можно только подсвеченные (отфильтрованные) объекты, что упрощает их поиск, редактирование и получение информации о них.
Сброс фильтра
Чтобы сбросить примененный фильтр, нажмите кнопку Clear .
Настройка визуальной фильтрации
Визуальный результат применения фильтра к документу в рабочей области определяется рядом элементов управления подсветкой. В редакторе можно выбрать эффект Normal, Mask или Dim; на практике наиболее заметную подсветку обеспечивает Mask .
Раскрывающийся список Normal / Mask / Dim позволяет выбрать способ визуального выделения объектов, соответствующих фильтру, на фоне остальных объектов рабочей области.

Выберите тип визуальной фильтрации в раскрывающемся списке режимов маскирования.
Визуальный эффект подсветки для каждого режима маскирования:
- Normal — объекты, соответствующие фильтру, видны в рабочей области, а внешний вид остальных объектов не изменяется.
- Mask — объекты, соответствующие фильтру, подсвечиваются в рабочей области, а все остальные объекты отображаются монохромно.
- Dim — объекты, соответствующие фильтру, подсвечиваются в рабочей области, а все остальные объекты сохраняют свои цвета, но отображаются затемненными.
Задание запросов фильтрации
В центральной части панели расположены элементы управления для создания фильтров путем ввода логических запросов.
Запрос можно ввести непосредственно в поле. По мере ввода появляется список возможных ключевых слов.
Для упрощения создания запросов доступны два инструмента: Query Helper и Query Builder. Они могут быть очень полезны, если вы не уверены в синтаксисе запроса или в том, какие ключевые слова можно использовать.
Помощник запросов (Query Helper)
Чтобы воспользоваться помощником запросов, нажмите кнопку Helper и откройте диалоговое окно Query Helper. Механизм обработки запросов анализирует документ и выводит список всех доступных объектов, а также общих ключевых слов для использования в запросах.
В верхней части диалогового окна составьте выражение запроса, используя доступные PCB Functions, PCB Object Lists и System Functions. В средней части диалогового окна представлены различные операторы для построения выражения. Нажмите кнопку Check Syntax, чтобы проверить синтаксическую корректность выражения.
Задав нужное выражение запроса, нажмите OK, чтобы загрузить запрос в центральную часть панели для последующего применения фильтра.
Конструктор запросов (Query Builder)
Чтобы воспользоваться конструктором запросов, нажмите кнопку Builder на панели и откройте диалоговое окно Building Query from Board. В этом окне можно создать запрос для выбора определенных объектов в документе проекта, составив последовательность условий, объединенных операторами AND и/или OR. В левой части диалогового окна задаются условия для выбора нужного набора объектов. Изначально в столбце Condition Type/Operator отображается значение Add first condition. Щелкните по нему один раз, чтобы открыть раскрывающийся список типов условий.
В списке представлены только типы условий, применимые к проекту печатной платы.
Выберите нужное условие, затем щелкните в столбце Condition Value, чтобы открыть раскрывающийся список возможных значений для этого типа условия. По мере задания условия в левой части диалогового окна в правой части отображается предварительный вид создаваемого запроса.
При необходимости продолжайте добавлять условия, чтобы сузить набор выбираемых объектов проекта. Условия можно объединять операторами AND или OR. По умолчанию используется логический оператор AND, который автоматически вставляется при добавлении очередного условия.
Чтобы изменить логический оператор между условиями, щелкните AND или OR в столбце Condition Type/Operator, затем выберите нужный оператор. Предварительный вид запроса обновится соответствующим образом.
Задание приоритета
Кнопки
и
в верхней части диалогового окна Building Query from Board позволяют добавлять и удалять скобки вокруг выбранного условия, увеличивая или уменьшая отступ. Это позволяет задать приоритет для определенных условий, объединенных логическими операторами AND или OR.
Например, рассмотрим следующий составленный запрос:
InNet('5V') AND (OnLayer('TopLayer')
Для первого условия выбран тип Belongs to Net со значением 16M_IN. Затем добавлено еще одно условие типа Exists on Layer со значением TopLayer.
На этом этапе в диалоговом окне было выбрано второе условие и нажата кнопка со стрелкой вправо. Вокруг второго условия автоматически добавились скобки, и теперь внутри этой пары скобок можно добавить еще одно условие.
Затем внутри скобок добавляется третье условие типа Object Kind is со значением Track.
Используйте раскрывающийся список Show Level в левом верхнем углу диалогового окна, чтобы управлять отображением уровней в структурированной последовательности условий. По сути, это разворачивает или сворачивает отображение скобок. Добавление скобок создает новый уровень. Можно выбрать отображение уровней с 1 по 5, а для отображения последующих уровней используйте вариант Show All Levels.
Также можно щелкнуть значок разворачивания или сворачивания, связанный с условием в скобках, чтобы соответственно показать следующие уровни или скрыть текущий уровень и все вложенные. Кнопки
и
в верхней части диалогового окна также позволяют развернуть или свернуть выбранное условие.
Используйте кнопки
и
в верхней части диалогового окна, чтобы перемещать выбранное условие в строке запроса. Если условие содержит вложенные уровни (то есть заключено в скобки), можно перемещать любое условие в этой иерархии. Когда уровни развернуты, условие можно перемещать вниз или вверх между уровнями. Когда уровни свернуты, условие перемещается через свернутую структуру уровней целиком.
Чтобы удалить условие, выберите его и нажмите кнопку
в верхней части диалогового окна или клавишу Delete.
Задав нужное выражение запроса, нажмите OK, чтобы загрузить запрос в центральную часть панели PCB Filter для последующего применения фильтра.
Создание правил проектирования
Панель PCB Filter также позволяет создать правило проектирования, область действия которого задается текущим выражением запроса в центральной части панели.
Чтобы добавить новое правило проектирования, нажмите кнопку Create Rule на панели PCB Filter. Откроется диалоговое окно Choose Design Rule Type.
В этом окне перечислены все категории и типы правил, доступные в документе печатной платы. Выберите тип создаваемого правила и нажмите OK или дважды щелкните по соответствующей строке. Откроется диалоговое окно PCB Rules and Constraints Editor.
Имя созданного правила будет выделено в дереве навигации слева. Выражение запроса правила отображается в правой верхней части диалогового окна.
Создается правило выбранного типа, и открывается его основное окно редактирования, в котором можно задать конкретные ограничения. Выражение запроса из панели PCB Filter вводится в область Full Query диалогового окна. При необходимости уточните настройки правила и примените новое правило.
Применение и сброс фильтра
После определения запроса и настройки необходимых параметров панели фильтр можно применить, нажав одну из кнопок Apply на панели или щелкнув Enter.
Чтобы сбросить текущий фильтр из панели, удалите выражение запроса в центральной области панели (выделите его и удалите), затем нажмите одну из кнопок Apply или клавишу Enter. Все объекты в рабочей области проекта снова станут полностью видимыми и доступными для выбора и редактирования.
Контекстные меню
Щелчок правой кнопкой мыши в панели PCB Filter открывает контекстные меню с дополнительными параметрами и командами.
Щелчок правой кнопкой мыши в области Object или Layer панели открывает контекстное меню со следующими командами:
- Toggle Check — изменяет состояние параметров на противоположное. Выбранные параметры будут отключены, а невыбранные — включены.
- Check All — выбирает все доступные параметры.
- Uncheck All — снимает выбор со всех доступных параметров.
Примечания
Общие сведения
- Нажатие клавиши F12 переключает видимость панели в рабочей области.
- Конструктор запросов (диалоговое окно Building Query from Board) позволяет легко создавать запросы с использованием контекстно-зависимых типов условий и значений: для построения доступны только подходящие «строительные блоки». Для создания сложных запросов с полным указанием ключевых слов и синтаксиса операторов используйте диалоговое окно Query Helper.
- Поскольку параметры отображения объектов, соответствующих и не соответствующих примененному фильтру, задаются отдельно, можно применять новые запросы фильтрации к результатам предыдущей фильтрации.
При составлении выражений запросов
-
Настоятельно рекомендуется использовать скобки во всех случаях, когда существует вероятность неправильной интерпретации запроса.
-
Скобки имеют наивысший приоритет в порядке приоритетов, установленном для доступных операторов. Этот порядок определяет, как программа интерпретирует запросы, если пользователь не расставил скобки. Порядок приоритетов следующий:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Этот порядок приоритетов аналогичен используемому в языках типа Pascal. Однако широкое использование скобок устраняет неоднозначность и облегчает чтение запросов другими пользователями. -
Неоднозначности разрешаются при обработке слева направо.
-
Выражения в скобках вычисляются от внутренних к внешним, а на одном уровне вложенности — слева направо.
Панель PCBLIB Filter
Обзор
Панель PCBLIB Filter содержит элементы управления для построения фильтров путем создания логических запросов. Заданный фильтр можно затем применить к активному посадочному месту компонента или ко всем посадочным местам компонентов в активной библиотеке посадочных мест, что позволяет точно и эффективно выбирать и редактировать сразу несколько объектов.
Доступ к панели
Открыть панель из редактора библиотек посадочных мест можно следующими способами:
- Нажмите кнопку Panels в правом нижнем углу рабочей области, затем выберите пункт PCBLIB Filter.
- Выберите View » Panels » PCBLIB Filter в главном меню.
- Используйте сочетание клавиш F12.
Разделы панели
Панель PCBLIB Filter состоит из трех областей. Первые две — это списки с возможностью выбора, которые совместно определяют область действия фильтра: Object и Layer. Третья область, Filter, отображает запрос, сформированный на основе выбранных в данный момент объектов и слоев.
Построение простых выражений фильтра
Основная область панели содержит элементы управления для быстрого построения простых выражений фильтра, охватывающих любые сочетания объектов. Типы объектов представлены в виде «матрицы объектов» и разделены на объекты цепей (Net), объекты компонентов (Comp) и свободные объекты (Free). В каждой из этих трех групп повторяется следующий основной список объектов:
- Дорожка
- Дуга
- Переходное отверстие
- Контактная площадка
- Заливка
- Область
Объект Text доступен в группах Comp и Free , однако, поскольку объекты этого типа не связаны с цепями, он не входит в группу Net . Кроме того, группа Free также включает Component, ComponentBody, Room и Polygon.
Например, если выбраны «Components» и «Top Layer», на виде платы будут подсвечены компоненты верхнего слоя. Выбор в обоих разделах панели отражает совокупный результат нескольких этапов фильтрации, что позволяет быстро подсветить любой тип объектов проекта.
Чтобы использовать объект при построении выражения фильтра, то есть выполнять фильтрацию по этому объекту, установите соответствующий флажок в матрице объектов. Команды контекстного меню этой области позволяют быстро установить или снять все флажки в матрице либо изменить состояние всех флажков на противоположное.
Используйте область Layer, чтобы ограничить действие фильтра определенным слоем, несколькими слоями или определенным классом слоев. В списке представлены:
-
Заданные для платы классы слоев, к которым по умолчанию относятся:
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- Слои, заданные в стеке слоев (как показано в Layer Stack).
- Верхний и нижний слои трафарета паяльной пасты.
По мере выбора параметров фильтрации результирующее выражение запроса формируется динамически и отображается в области Filter панели. После того как выражение запроса фильтра сформировано, его необходимо применить отдельным действием. Для этого нажмите кнопку Apply to All в нижней части панели. Если же фильтр требуется применить только к объектам, выделенным в данный момент в рабочей области, используйте кнопку Apply to Selected.
Применение фильтрации
Компоненты библиотеки посадочных мест состоят из графических примитивов (дуг, контактных площадок, дорожек и т. д.), размещенных на разных слоях платы. Объекты могут быть «свободными» или принадлежать групповому объекту. Обратите внимание: при выборе Free в области Object подсвечиваются только те объекты, которые не входят в состав группового объекта.
Фильтрация по объектам
Выбор в списке Object панели задает фильтрацию вида платы для отображения графических примитивов проекта. Все объекты будут подсвечены, если настройки списка фильтрации Layer не задают иное.

Пример платы с выбранными Track и Arc в разделе Object. Для Layer установлено значение Top Overlay.
Фильтрация по слоям
Выбор в списке Layers панели задает фильтрацию вида платы для отображения объектов на указанном физическом слое проекта (сигнальном слое, слое маски или шелкографии). Все объекты на соответствующих слоях будут подсвечены, если настройки списка фильтрации Object не задают иное.

Пример платы, где для Object установлено значение Pad. Layer , а также задано значение Top Layer.
Выделение отфильтрованных объектов
Совместное действие фильтров панели PCBLIB Filter упрощает просмотр и выделение нужных объектов проекта платы.
Выделять можно только подсвеченные (отфильтрованные) объекты, что упрощает их поиск, редактирование и получение сведений о них.
Сброс фильтра
Сбросьте текущий фильтр с помощью кнопки Clear на панели.
Настройка визуальной фильтрации
Визуальный результат применения фильтра к документу в рабочей области определяется набором элементов управления подсветкой. Для отображения в редакторе можно выбрать режим Normal, Mask или Dim; на практике наиболее заметный эффект подсветки дает режим Mask .
Раскрывающийся список Normal / Mask / Dim содержит варианты визуального разграничения отфильтрованных и остальных объектов в рабочей области.

Выберите тип визуальной фильтрации в раскрывающемся списке режимов маскирования.
Визуальный эффект подсветки для каждого режима маскирования:
- Normal — отфильтрованные объекты видны в рабочей области, а внешний вид остальных объектов не изменяется.
- Mask — отфильтрованные объекты подсвечиваются в рабочей области, а все остальные объекты отображаются монохромно.
- Dim — отфильтрованные объекты подсвечиваются в рабочей области, а все остальные сохраняют свои цвета, но отображаются приглушенно.
Определение запросов фильтрации
Центральная область панели позволяет создавать фильтры путем ввода логических запросов.
Запрос можно вводить непосредственно в поле. По мере ввода будет появляться список подсказок с возможными ключевыми словами.
Для упрощения создания запросов предусмотрены два инструмента: помощник запросов (Query Helper) и конструктор запросов (Query Builder). Они особенно полезны, если вы не уверены в синтаксисе запроса или в том, какие ключевые слова можно использовать.
Помощник запросов
Чтобы воспользоваться помощником запросов, нажмите кнопку Helper, открывающую диалоговое окно Query Helper. Встроенный механизм обработки запросов анализирует документ и выводит список всех доступных объектов, а также общих ключевых слов для использования в запросах.
Используйте верхнюю часть диалогового окна для составления выражения запроса с помощью доступных PCB Functions, PCB Object Lists и System Functions. В средней части диалогового окна представлены различные операторы для построения выражения. Чтобы проверить синтаксическую корректность выражения, нажмите кнопку Check Syntax.
После того как выражение запроса сформировано, нажмите OK, чтобы загрузить запрос в центральную область панели PCBLIB Filter и подготовить его к применению.
Конструктор запросов
Чтобы воспользоваться конструктором запросов, нажмите кнопку Builder на панели PCBLIB Filter. Откроется диалоговое окно Building Query from Board.
В этом диалоговом окне можно создать запрос для поиска определенных объектов в документе проекта, составив последовательность условий, объединенных логическими операторами AND и/или OR.
В левой части диалогового окна задаются условия для выбора нужного набора объектов. Изначально в столбце Condition Type/Operator отображается запись Add first condition. Щелкните эту запись один раз, чтобы открыть раскрывающийся список типов условий.
В списке представлены только типы условий, применимые к проекту платы.
Выберите условие, затем щелкните в столбце Condition Value, чтобы открыть раскрывающийся список возможных значений для этого типа условия. По мере задания условия в левой части диалогового окна в правой части отображается предварительный вид формируемого запроса.
При необходимости добавляйте новые условия, чтобы сузить набор искомых объектов проекта. Условия можно объединять операторами AND или OR. По умолчанию используется логический оператор AND, который автоматически вставляется при добавлении очередного условия.
Чтобы изменить логический оператор между условиями, щелкните запись AND или OR в столбце Condition Type/Operator и выберите нужный оператор. Предварительный вид запроса обновится соответствующим образом.
Задание приоритета
Кнопки
и
в верхней части диалогового окна Building Query from Board позволяют добавлять и удалять скобки вокруг выбранного условия (увеличивая и уменьшая отступ). Это позволяет задавать приоритет для определенных условий, объединенных логическими операторами AND или OR.
Для первого условия задан тип Exists on Layer со значением Top Layer. Затем добавлено ещё одно условие типа Object Kind is со значением Arc.
На этом этапе, когда в диалоговом окне было выбрано второе условие, была нажата кнопка со стрелкой вправо. Вокруг второго условия автоматически добавлены скобки, и теперь внутрь этой пары скобок можно добавить условие.
Затем внутри скобок добавляется третье условие типа In Any Polygon .
Используйте раскрывающийся список Show All Levels в левом верхнем углу диалогового окна, чтобы управлять отображением уровней в структурированной строке условий. По сути, это позволяет разворачивать и сворачивать отображение скобок. Добавление скобок фактически создаёт новый уровень. Можно отображать уровни с 1 по 5, а для всех последующих добавленных уровней используйте параметр Show All Levels.
Также можно нажимать значки разворачивания или сворачивания рядом с условием в скобках, чтобы соответственно показать следующие уровни или скрыть текущий уровень и все вложенные уровни. Кнопки
и
в верхней части диалогового окна также позволяют развернуть или свернуть выбранное условие.
Используйте кнопки
и
в верхней части диалогового окна, чтобы переместить выбранное условие в формируемой строке запроса. Для условия с вложенными уровнями (то есть условия в скобках) можно перемещать любое условие в иерархии уровней. Когда уровни развёрнуты, условие можно перемещать вниз или вверх по уровням. Когда уровни свёрнуты, условие перемещается целиком через свёрнутые уровни.
Чтобы удалить условие, выберите его и нажмите кнопку
в верхней части диалогового окна или клавишу Delete.
Когда выражение запроса будет сформировано нужным образом, нажмите OK, чтобы загрузить запрос в центральную область панели PCBLIB Filter и подготовить его к применению фильтра.
Создание правил проектирования
Панель PCBLIB Filter также позволяет создавать правила проектирования. Область действия правила будет определяться выражением запроса, заданным в центральной области панели.
Чтобы добавить новое правило проектирования, нажмите кнопку Create Rule на панели PCBLIB Filter. Откроется диалоговое окно Choose Design Rule Type.
В этом диалоговом окне перечислены все категории и типы правил, доступные в документе печатной платы. Выберите тип создаваемого правила и нажмите OK (или дважды щёлкните нужную запись). Откроется диалоговое окно Редактор правил и ограничений печатной платы.
Имя созданного правила будет выделено в дереве навигации слева. Выражение запроса для правила находится в правой верхней области диалогового окна.
Будет создано правило выбранного типа и открыто основное окно его редактирования, в котором можно задать конкретные ограничения. Выражение запроса из панели PCBLIB Filter переносится в область Full Query диалогового окна. При необходимости уточните настройки правила и примените новое правило.
Применение и сброс фильтра
После того как вы задали запрос и настроили необходимые параметры панели, фильтр можно применить, нажав кнопку Apply на панели или клавишу Enter.
Чтобы сбросить текущий фильтр с помощью панели, очистите выражение запроса в центральной области панели (выделите и удалите его), затем нажмите кнопку Apply или клавишу Enter. Все объекты в рабочей области проекта снова будут полностью видимы и доступны для выбора и редактирования.
Контекстные меню
Щёлкните правой кнопкой мыши внутри панели PCBLIB Filter, чтобы получить доступ к дополнительным параметрам и командам во всплывающих меню.
Щелчок правой кнопкой мыши в области Object или Layer панели открывает контекстное меню со следующими пунктами:
- Toggle Check — инвертировать выбор параметров. Выбранные параметры будут отключены, а невыбранные — включены.
- Check All — выбрать все доступные параметры.
- Uncheck All — снять выбор со всех доступных параметров.
Примечания
Общие сведения
- Нажатие клавиши F12 переключает видимость панели в рабочей области.
- Конструктор запросов (диалоговое окно Построение запроса по плате) позволяет легко создавать запросы, предлагая контекстно-зависимые типы условий и значения, то есть только подходящие «строительные блоки». Для создания более сложных запросов с полным набором ключевых слов и синтаксисом операторов используйте диалоговое окно Помощник по запросам.
- Поскольку параметры отображения объектов, соответствующих и не соответствующих применённому фильтру, задаются раздельно, можно применять новые запросы фильтрации к результатам предыдущей фильтрации.
При построении выражений запросов
- Настоятельно рекомендуется использовать скобки во всех случаях, когда есть вероятность неправильной интерпретации запроса.
-
Скобки имеют наивысший приоритет в порядке приоритетов, установленном для доступных операторов. Этот порядок определяет, как программа интерпретирует запросы, если пользователь не расставил скобки. Порядок приоритетов следующий:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Этот порядок приоритетов похож на используемый в языках семейства Pascal. Однако активное использование скобок устраняет неоднозначность и делает полученные запросы более понятными для других пользователей. - Неоднозначности разрешаются при обработке слева направо.
- Выражения в скобках вычисляются от внутренних к внешним, а выражения одного уровня — слева направо.
Где найти результаты запроса?
Итак, вы составили запрос в панели Filter . Как получить доступ к объектам, найденным по этому запросу? В среде Altium Designer доступны два способа доступа к объектам и их редактирования.
-
Графически — после применения фильтра по умолчанию все объекты, не соответствующие запросу, маскируются (отображаются приглушённо и становятся недоступными для редактирования), а остальные остаются без изменений. Этот режим отлично подходит для поиска и просмотра объектов в рабочей области. Поскольку замаскированные объекты недоступны для редактирования, такие команды, как Ctrl+A (выбрать всё), применяются только к объектам, найденным по запросу.
-
List панель — панель List (Shift+F12) представляет данные проекта в виде электронной таблицы. По умолчанию в ней отображаются все объекты проекта, но после применения фильтра — только объекты, возвращаемые запросом. Панель List поддерживает стандартные для электронных таблиц операции сортировки и выделения, позволяя напрямую редактировать одну или несколько ячеек.
Панели PCB List и SCH List отображают результаты запросов PCB/SCH из предыдущего раздела.
Параметры подсветки
При каждом применении запроса (или ином использовании функции фильтрации данных) для каждого объекта целевого документа определяется, входит ли он в результаты фильтрации. Однако то, как впоследствии отображаются объекты, вошедшие и не вошедшие в результаты, зависит от параметров подсветки, выбранных на панели Filter . Доступны три независимых параметра подсветки: можно выбрать один, два или все три.
Масштабирование
Если при применении запроса включен параметр Zoom , вид целевого документа обновляется так, чтобы отображалась область, занимаемая всеми объектами, вошедшими в результаты. Отображение остальных объектов в обновленном виде зависит от их расположения относительно этой области: каждый из них может отображаться полностью, частично или не отображаться вовсе.
Этот параметр часто выбирают совместно с одним или обоими другими параметрами. Если параметр Mask не включен, объекты, не вошедшие в результаты, по-прежнему будут отображаться в графическом представлении, если они находятся в пределах обновленной области просмотра. На первый взгляд использование только этого параметра может показаться бессмысленным. Однако иногда требуется изменить графическое представление так, чтобы оно охватывало определенные объекты, не меняя при этом состояние выделения или маскирования каких-либо объектов документа.
Выделение
Если параметр Select включен, все объекты, вошедшие в результаты, выделяются, а со всех остальных объектов выделение снимается. Выделенные объекты отображаются более заметно, чем невыделенные.
Если при применении текущего запроса выбран параметр Select, все объекты, входящие в набор результатов, переходят в выделенное состояние, а все остальные объекты (не входящие в набор результатов) — в невыделенное. Этот параметр обычно выбирают непосредственно перед операциями глобального редактирования, поскольку при их выполнении изменяются свойства только выделенных объектов. Однако параметр Select может быть полезен и в других случаях, например при перемещении, копировании или удалении определенных объектов.
Маскирование
Параметр подсветки Mask определяет новое состояние маскирования объектов в целевом документе. Если он выбран, все объекты, вошедшие в результаты, маскируются, а со всех остальных объектов маскирование снимается. Главная особенность маскированных объектов заключается в том, что ни сами объекты, ни их свойства нельзя редактировать. (Маскированные объекты отображаются в списке приглушенными, но появляются в нем только в том случае, если на панели List выбран параметр all objects .) Главная особенность маскированных объектов заключается в том, что ни сам объект, ни его свойства нельзя редактировать.
Конструктор запросов
В редакторе печатных плат предусмотрено специальное диалоговое окно Query Builder. Оно позволяет создавать сложные запросы, выбирая условия проверки из раскрывающихся списков. Одно из преимуществ Query Builder — возможность создавать запросы для разных типов объектов.
Диалоговое окно Building Query (часть функции Query Builder) помогает пользователям, имеющим небольшой опыт составления запросов: запрос автоматически формируется в соответствии с условиями, заданными разработчиком.
В левой части этого диалогового окна расположены элементы управления, помогающие разработчику задать свойства, которыми должен обладать объект документа, чтобы попасть в результаты формируемого запроса. При добавлении или изменении каждого условия соответствующий запрос обновляется и отображается в правой части окна. Если затем закрыть окно нажатием кнопки OK (или Apply), запрос будет применен либо его текст будет скопирован обратно на панель Filter — в зависимости от того, каким способом было открыто это диалоговое окно.
Диалоговое окно Query Builder можно открыть следующими способами (как показано на рисунке ниже):
- На панели PCB Filter нажмите кнопку Query Builder , чтобы создать запрос и загрузить его строку на панель.
- В диалоговом окне PCB Rules and Constraints Editor нажмите кнопку Builder , чтобы создать запрос, определяющий объекты, к которым применяется это правило.
На рисунке ниже показано использование диалогового окна Query Builder для создания запроса, выбирающего контактные площадки и переходные отверстия цепи 5V.

Диалоговое окно Query Builder
Параметры и элементы управления диалогового окна Query Builder
-
Show All Levels — используйте раскрывающийся список для управления отображением уровней в структурированной строке условий. По сути, этот элемент разворачивает или сворачивает отображение скобок. Добавление скобок создает новый уровень; можно отображать уровни с 1-го по 5-й. Также можно нажать символ развертывания или свертывания , чтобы соответственно показать следующие уровни или скрыть текущий уровень и все вложенные.
-
— удаляет скобки вокруг выбранного условия, уменьшая отступ. Это позволяет задавать приоритет определенных условий, объединенных логическими операторами И или ИЛИ.
-
— добавляет скобки вокруг выбранного условия, увеличивая отступ. Это позволяет задавать приоритет определенных условий, объединенных логическими операторами И или ИЛИ.
-
— перемещает выбранное условие вверх в формируемой строке запроса. Для условия с вложенными уровнями (то есть условия в скобках) можно перемещать любое условие в структуре уровней. Если уровни развернуты, условие можно перемещать вверх между уровнями. Если уровни свернуты, условие перемещается через свернутую структуру уровней целиком.
-
— перемещает выбранное условие вниз в формируемой строке запроса. Для условия с вложенными уровнями (то есть условия в скобках) можно перемещать любое условие в структуре уровней. Если уровни развернуты, условие можно перемещать вниз между уровнями. Если уровни свернуты, условие перемещается через свернутую структуру уровней целиком.
-
— разворачивает структуру, отображая следующие уровни.
-
- используйте для сворачивания символов, чтобы скрыть текущий уровень (и все нижележащие уровни).
-
- используйте для удаления выбранного условия.
- Condition Type/Operator - используйте эту область, чтобы задать условия для выбора нужного набора объектов. Изначально в столбце Condition Type/Operator будет указано Add first condition. Щелкните эту запись один раз, чтобы открыть раскрывающийся список типов условий. Содержимое списка зависит от того, откуда было открыто диалоговое окно. Если вы создаете запрос для определенного правила проектирования в диалоговом окне PCB Rules And Constraints Editor , список будет содержать только типы условий, допустимые для этого типа правил.
- Condition Value - выберите первое условие, затем щелкните в столбце Condition Value , чтобы открыть раскрывающийся список возможных значений для этого типа условия. По мере задания условия в области Query Preview отображается предварительный вид создаваемого запроса.
Помощник по запросам
Следующий шаг в освоении составления запросов — использование диалогового окна Query Helper. Диалоговое окно Query Helper содержит поле Query , в котором можно ввести нужный запрос, используя кнопки синтаксиса под полем Query (например, And, Or, <, Not, Like и т. д.), а также полный список всех ключевых слов запросов в поле Categories .
Диалоговое окно «Помощник по запросам» помогает проектировщикам создавать собственные запросы. Для каждого ключевого слова в списке приведено краткое описание. Чтобы открыть интерактивную справку, выделите ключевое слово и нажмите клавишу F1. Откроется диалоговое окно библиотеки документации Altium Designer, в котором подробно описано, какие объекты документа возвращает выделенное ключевое слово, как его использовать, а также приведен один или несколько примеров использования.
Диалоговое окно можно открыть следующими способами:
- Нажмите кнопку Helper на панели Filter .
PCB Filter доступ через панель
SCH Filter доступ через панель
-
В диалоговом окне Поиск в файловых библиотеках (чтобы открыть его, щелкните
в правом верхнем углу панели Компоненты, затем выберите File-based Libraries Search в раскрывающемся меню) нажмите кнопку Helper .
File-based Libraries Search доступ через диалоговое окно
Используйте раздел Query в верхней части диалогового окна, чтобы составить выражение запроса с помощью доступных функций. В текстовом поле можно просмотреть и/или дополнительно отредактировать поисковое выражение. Для редактирования вводите текст непосредственно в это поле. Чтобы найти нужные ключевые слова для добавления, начните вводить текст. По мере ввода в диалоговом окне будет появляться раскрывающееся меню доступных ключевых слов, соответствующих уже введенному тексту. Щелкните ключевое слово, чтобы автоматически завершить ввод. Если нужное ключевое слово выделено, нажатие Enter также автоматически завершит ввод.
Найдите нужное ключевое слово в Categories доступных ключевых слов. Используйте поле Mask, если не знаете точное ключевое слово. Например, в Query Helper редактора схем ввод *har в поле Mask позволяет найти ключевые слова, относящиеся именно к жгутам, как показано на изображении ниже. Обратите внимание, что поле Mask выполняет поиск как по полю Name ключевого слова, так и по полю Description , поэтому с его помощью можно быстрее всего найти подходящие ключевые слова.
Дважды щелкните ключевое слово в таблице, чтобы добавить его в запрос в текущей позиции курсора.
В средней области диалогового окна расположены кнопки синтаксиса с различными операторами для составления выражений. Подробнее о назначении каждой кнопки синтаксиса см. в разделе Логические операторы выражений запросов ниже. Используйте кнопку Check Syntax (в левом нижнем углу диалогового окна), чтобы проверить синтаксическую правильность выражения.
История запросов
При вводе и применении нового запроса на панели фильтрации (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) он добавляется в историю запросов. Чтобы открыть этот список, нажмите кнопку History на панели. Откроется диалоговое окно Expression Manager с активной вкладкой History .
На вкладке История диалогового окна Expression Manager приведен список ранее использованных выражений запросов. Здесь показан пример истории запросов для схемы. Наведите указатель мыши на изображение, чтобы увидеть аналогичный пример списка для печатной платы.
Чтобы использовать запрос из истории, выберите его запись в списке и нажмите кнопку Apply Expression или дважды щелкните саму запись. Диалоговое окно закроется, а выражение запроса будет загружено в центральную область соответствующей панели фильтрации.
Запрос из истории можно добавить в список избранных запросов, выбрав его запись и нажав кнопку Add To Favorites. Для очистки истории используйте кнопку Clear History.
До девяти последних использованных выражений запросов из списка будут доступны в подменю History контекстного меню панели фильтрации.
Избранные запросы
Любой заданный запрос можно добавить в список избранных запросов двумя способами:
- Нажмите кнопку Add To Favorites или щелкните правой кнопкой мыши в основной области Query Expression и выберите команду Add to Favorites в контекстном меню, чтобы добавить выражение запроса, заданное в данный момент в центральной области активной панели фильтрации.
- Выберите запись запроса из истории на вкладке History диалогового окна Expression Manager, затем нажмите кнопку Add To Favorites.
Избранные выражения запросов сохраняются на вкладке Favorites диалогового окна Expression Manager, где также выполняется управление ими. Открыть это окно можно с помощью кнопки Favorites на панели фильтрации (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) или щелкнув правой кнопкой мыши в основной области Query Expression панели фильтрации и выбрав команду Organize Favorites в контекстном меню. Из рабочей области проекта это диалоговое окно можно открыть, нажав сочетание клавиш Y, а затем выбрав Organize Favorites во всплывающем меню фильтрации.
Откройте список избранных запросов с панели фильтрации редактора или из рабочей области проекта через всплывающее меню фильтрации.
При добавлении выражения запроса в список Favorites ему присваивается уникальное имя. По умолчанию присваивается стандартное имя — Favorite_n, где n — следующий свободный номер. Имя записи можно изменить в любой момент одним из следующих способов:
- Выберите запись запроса и нажмите кнопку Rename.
- Выберите запись запроса, затем выберите команду Изменить в контекстном меню.
- Выберите запись запроса, затем повторно щелкните в поле Name.
В каждом случае введите нужное имя, а затем щелкните за пределами поля Name, чтобы применить изменение.
Чтобы изменить избранное выражение запроса, выберите его запись в списке и нажмите кнопку Edit (или щелкните правой кнопкой мыши и выберите Edit в контекстном меню). Откроется диалоговое окно Edit Favorite. В нем можно изменить имя избранного запроса и само выражение, а также определить способ обработки объектов проекта — как соответствующих фильтру, так и не соответствующих ему.
Изменение существующего избранного запроса в диалоговом окне Edit Favorite, показанном здесь для схемы (слева) и печатной платы (справа).
Чтобы удалить запрос из списка Favorites , выберите его запись в списке, затем нажмите кнопку Remove или выберите команду Remove в контекстном меню. Появится диалоговое окно с запросом подтверждения удаления.
Использование избранных запросов
Использовать избранные запросы можно тремя способами:
-
На вкладке Favorites диалогового окна Expression Manager — выберите запись запроса и нажмите кнопку Apply Expression или дважды щелкните по записи. Диалоговое окно закроется, а выражение запроса будет загружено в центральную область соответствующей панели фильтрации.
-
В верхней части контекстного меню панели фильтрации (доступно до десяти выражений запросов, последними добавленных в список Favorites ).
-
Во всплывающем меню фильтрации рабочей области проекта (нажмите Y) — в верхней части меню отображается до десяти избранных выражений запросов. Выбранное выражение запроса будет загружено в центральную область соответствующей панели фильтрации.
Использование готовых примеров
Редакторы схем и печатных плат поставляются с набором готовых примеров запросов. Эти примеры доступны в меню фильтрации, которое можно открыть щелчком правой кнопки мыши в области выражения на панели фильтрации или с помощью сочетания клавиш Y в рабочей области проекта. Наведите указатель на Examples, чтобы открыть подменю.
При выборе пункта подменю применяется запрос, соответствующий этому фильтру. Чтобы увидеть само выражение запроса из примера, после его применения откройте список History . Этот список также доступен во всплывающем меню фильтрации.
Инструменты построения запросов
Пожалуй, самый простой способ написать запрос — поручить это Altium Designer! Для этого можно использовать диалоговое окно Find Similar Objects или диалоговое окно Query Builder .
Диалоговое окно поиска похожих объектов
При использовании диалогового окна поиска похожих объектов формируется запрос для поиска нужных объектов. Если включен параметр Create Expression, этот запрос отображается на панели Filter . Это отличный способ изучить различные ключевые слова запросов.
Диалоговое окно Find Similar Objects открывается, если щелкнуть правой кнопкой мыши по любому незамаскированному объекту в документе проекта и выбрать Find Similar Objects в контекстном меню.
Слева: версия для печатных плат; справа: версия для схем
Это диалоговое окно позволяет найти объекты, похожие на тот, по которому вы щелкнули правой кнопкой мыши, а затем указать, какие атрибуты объекта должны совпадать (или различаться) для соответствия условиям поиска. Предположим, вы хотите изменить все контактные площадки GND в проекте. Можно щелкнуть правой кнопкой мыши по одной из таких площадок, выбрать Find Similar Objects, а затем изменить значение поля Net с Any (настройка по умолчанию) на Same. При нажатии Apply в диалоговом окне будут выделены все контактные площадки GND. Если включен параметр Create Expression , на панели Filter появится следующий запрос: (ObjectKind = 'Pad') And (Net = 'GND').
Например, на схеме можно задать одинаковое значение свойства Color для всех объектов питания в документе с определенным значением свойства Text (например, 'GND'). Аналогично, на печатной плате можно задать одинаковое значение свойства Hole Size для всех переходных отверстий в документе с определенным значением свойства Via Diameter.
Параметр Clear Existing
Включите параметр Clear Existing , чтобы сбросить текущее выделение или маску редактирования перед выполнением поиска. Отключите этот параметр, если вы выполняете несколько последовательных поисков и хотите накапливать их результаты.
Панель инструментов фильтрации
Панель Filter Toolbar доступна для документов печатных плат и позволяет маскировать все объекты в документе, кроме объектов с указанным свойством или объектов, входящих в состав указанного компонента. Крайнее правое поле панели инструментов используется для задания запроса. Можно ввести запрос в это поле или выбрать один из последних запросов в раскрывающемся списке (из списка History запросов). При применении запросов с панели Filter Toolbar нельзя указать используемые параметры: во всех случаях предыдущий запрос сбрасывается, а к текущему запросу применяются параметры Mask и Zoom. Чтобы использовать параметры запросов, воспользуйтесь панелью Filter , диалоговым окном Query Builder, диалоговым окном Query Helper или диалоговым окном Find Similar Objects .
Операторы логических выражений запросов
Ниже приведено краткое описание операторов, которые можно использовать при составлении логических выражений на языке запросов.
Арифметические операторы
| Оператор | Описание | Пример |
|---|---|---|
| + | Оператор сложения | NetPinCount + NetViaCount |
| - | Оператор вычитания | ArcStopAngle - ArcStartAngle |
| * | Оператор умножения | PadXSize_BottomLayer * PadYSize_BottomLayer |
| / | Оператор деления | HoleDiameter / ViaDiameter |
| Div | Оператор целочисленного деления | Color Div 65536 Вычисляется результат деления Color на 65536, дробная часть результата отбрасывается |
| Mod | Оператор остатка от деления | Color Mod 256 Вычисляется остаток от деления Color на 256 без определения дробной части результата |
Логические операторы
| Оператор | Описание | Пример |
|---|---|---|
| And | Оператор логического И | IsPad And OnMultiLayer Чтобы попасть в результаты запроса, объект должен быть контактной площадкой и находиться на слое Multi-Layer |
| && | Оператор логического И (более низкий приоритет) |
IsPad && OnMultiLayer Чтобы попасть в результаты запроса, объект должен быть контактной площадкой и находиться на слое Multi-Layer |
| Or | Оператор логического ИЛИ | IsPad Or IsVia Чтобы попасть в результаты запроса, объект должен быть контактной площадкой или переходным отверстием |
| || | Оператор логического ИЛИ (более низкий приоритет) |
IsPad || IsVia Чтобы попасть в результаты запроса, объект должен быть контактной площадкой или переходным отверстием |
| Xor | Оператор логического исключающего ИЛИ | OnMultiLayer Xor (HoleDiameter <> 0) Чтобы попасть в результаты запроса, объект должен либо находиться на слое Multi-Layer и иметь нулевое значение Hole Diameter, либо не находиться на слое Multi-Layer и иметь ненулевое значение Hole Diameter. |
| Not | Оператор логического НЕ | Not OnMultiLayer Чтобы попасть в результаты запроса, объект не должен находиться на слое Multi-Layer |
Операторы сравнения
| Оператор | Описание | Пример |
|---|---|---|
| < | Оператор «меньше» | HoleDiameter < 40 Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter меньше 40 |
| <= | Оператор «меньше или равно» | HoleDiameter <= 40 Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter меньше или равное 40 |
| >= | Оператор «больше или равно» | HoleDiameter >= 40 Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter больше или равное 40 |
| > | Оператор «больше» | HoleDiameter > 40 Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter больше 40 |
| <> | Оператор «не равно» | HoleDiameter <> 40 Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter, не равное 40 |
| = | Оператор «равно» | HoleDiameter = 40 Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter, равное 40 |
| Between...And... | Оператор диапазона с включенными границами | HoleDiameter Between 30 And 50 Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter больше или равное 30 и меньше или равное 50. |
| Like | Оператор Like | Name Like 'ADDR?*' Возвращает объекты, у которых текстовая строка свойства Name начинается с ADDR и содержит как минимум еще один символ |
Подстановочные символы
Подстановочные символы позволяют задавать строки, содержимое которых определено не полностью. Обычно эти символы используются в сочетании с другими символами, в результате чего получаются частично заданные строки. Некоторые ключевые слова в виде исключения допускают строковые параметры, заданные не полностью, однако в большинстве случаев строки могут содержать подстановочные символы только при сравнении с помощью оператора Like.
| Оператор | Описание | Пример |
|---|---|---|
| ? | Может заменять один символ любого типа | Footprint Like 'DIP1?' Возвращает объекты, у которых свойство Footprint имеет значение DIP10, DIP12, DIP14 и т. д. |
| * | Может заменять любое количество символов любого типа | Footprint Like 'SIP*' Возвращает объекты, у которых свойство Footprint имеет значение SIP1, SIP12, SIP216 и т. д. (Также возвращаются все объекты, у которых свойство Footprint имеет значение SIP, поскольку '*' может заменять и no символов.) |
Логические строки
| Оператор | Описание | Пример |
|---|---|---|
| True | Подтверждает условие, заданное ключевым словом | IsPad = True Чтобы попасть в результат, объект должен быть контактной площадкой |
| False | Отрицает условие, заданное ключевым словом | IsVia = False Чтобы попасть в результат, объект не должен быть переходным отверстием |
Круглые скобки и приоритет операций
Стоит ознакомиться с приоритетом операторов, используемых в логических выражениях запросов. Без этого выражение может выбирать не те объекты, которые требуются.
Круглые скобки имеют наивысший приоритет в порядке выполнения операций, установленном для различных операторов. Этот порядок определяет, как программа интерпретирует запросы, если пользователь не расставил круглые скобки. Ниже приведен порядок от наивысшего приоритета к наименьшему:
- Круглые скобки ()
- Not
- ^, *, /, Div, Mod, And
- +, -, Or, Xor
- =, <>, <, >, <=, >=
- &&, ||
Глобальные системные функции запросов

Глобальные системные функции запросов в диалоговом окне Query Helper
В этом разделе подробно описаны ключевые слова языка запросов, доступные в документах схем, печатных плат и библиотек в Altium Designer. Чтобы получить справку по определенному ключевому слову запроса, воспользуйтесь приведенными ниже раскрывающимися разделами либо выделите нужное ключевое слово (или щелкните внутри него) в Query Helper, на панели Filter или в поле Query правила проектирования печатной платы и нажмите F1, чтобы сразу перейти к соответствующему разделу.
Арифметические функции
ABS
Общие сведения
Возвращает вещественное число, равное абсолютному значению числового значения параметра. Если это значение положительное, возвращается то же самое значение; в противном случае возвращается числовое значение параметра, умноженное на -1.
Синтаксис
ABS(X : Number / Numeric_String) : Number
Примеры использования
ABS(2.3)
Возвращает 2.3.
ABS(-7.2)
Возвращает 7.2.
CEIL
Общие сведения
Возвращает целое число, зависящее от числового значения параметра. Если это значение является целым числом, возвращается то же самое значение; в противном случае возвращается наименьшее целое число, превышающее числовое значение параметра.
Синтаксис
CEIL(X : Number / Numeric_String) : Number
Примеры использования
CEIL(5.0)
Возвращает 5.
CEIL(5.33)
Возвращает 6.
CEIL(-5.0)
Возвращает -5.
CEIL(-5.33)
Возвращает -5.
FLOOR
Общие сведения
Возвращает целое число, зависящее от числового значения параметра. Если это значение является целым числом, возвращается то же самое значение; в противном случае возвращается наибольшее целое число, меньшее числового значения параметра.
Синтаксис
FLOOR(X : Number / Numeric_String) : Number
Примеры использования
FLOOR(5.0)
Возвращает 5.
FLOOR(5.33)
Возвращает 5.
FLOOR(-5.0)
Возвращает -5.
FLOOR(-5.33)
Возвращает -6.
FRAC
Общие сведения
Возвращает вещественное число, зависящее от числового значения параметра:
- Если это значение положительное, но не является целым числом, возвращается разность между числовым значением параметра и наибольшим целым числом, меньшим этого значения.
- Если это значение отрицательное, но не является целым числом, возвращается разность между числовым значением параметра и наименьшим целым числом, превышающим это значение.
- Если числовое значение параметра является целым числом, возвращается 0.
Синтаксис
FRAC(X : Number / Numeric_String) : Number
Примеры использования
FRAC(5.0)
Возвращает 0.
FRAC(5.33)
Возвращает 0.33.
FRAC(-5.0)
Возвращает 0.
FRAC(-5.33)
Возвращает -0.33.
IIF
Общие сведения
Это специальная конструкция, содержащая три запроса. Сначала вычисляется значение первого запроса (между открывающей скобкой и первой запятой). Если оно равно True, возвращается второй запрос (между запятыми); в противном случае возвращается третий запрос (между второй запятой и закрывающей скобкой).
Синтаксис
IIF(L : Boolean Query , A : Query , B : Query)
L, A и B — строки, каждая из которых задает определенный запрос; L должен быть логическим запросом (то есть возвращать результат True или False).
Примеры использования
IsArc And IIF(ArcStopAngle - ArcStartAngle >= 0 , ArcStopAngle - ArcStartAngle Between 30 And 60 , ArcStartAngle - ArcStopAngle Between 300 And 330)
Возвращает все дуги с угловой длиной не менее 30 и не более 60 градусов. (Угловая длина дуги — это угол, определяемый вычитанием значения свойства Start Angle из значения свойства Stop Angle. Следует учитывать, что значение свойства Stop Angle дуги может быть меньше значения свойства Start Angle, однако этот запрос правильно вычисляет фактическую угловую длину для любых объектов-дуг.)
IsComponent And IIF(Layer = 'Top Layer' , Rotation <> 0 , Rotation <> 180)
Возвращает все компоненты на верхней стороне печатной платы, у которых значение свойства Rotation не равно 0 градусов, и все компоненты на нижней стороне печатной платы, у которых значение свойства Rotation не равно 180 градусов. (Объекты-компоненты могут располагаться только на сигнальном слое Top или Bottom, поэтому любой компонент, находящийся не на сигнальном слое Top, обязательно находится на сигнальном слое Bottom.)
INT
Краткое описание
Возвращает целое число, значение которого зависит от числового значения параметра:
- Если это числовое значение положительное, но не целое, возвращается наибольшее целое число, меньшее числового значения параметра.
- Если это числовое значение отрицательное, но не целое, возвращается наименьшее целое число, большее числового значения параметра.
- Если это числовое значение целое, возвращается то же самое значение.
Синтаксис
INT(X : Number / Numeric_String) : Number
Примеры использования
INT(5.0)
Возвращает 5.
INT(5.33)
Возвращает 5.
INT(-5.0)
Возвращает -5.
INT(-5.33)
Возвращает -5.
Советы
Это псевдоним арифметической функции TRUNC.
MAX
Краткое описание
Возвращает вещественное число, равное максимальному значению из всех переданных параметров. Каждый параметр должен быть числом или числовой строкой; количество параметров может быть любым.
Синтаксис
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Примеры использования
MAX(2)
Возвращает 2.
MAX(7,2,3)
Возвращает 7.
Советы
Необходимо передать хотя бы один параметр.
MIN
Краткое описание
Возвращает вещественное число, равное минимальному значению из всех переданных параметров. Каждый параметр должен быть числом или числовой строкой; количество параметров может быть любым.
Синтаксис
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Примеры использования
MIN(2)
Возвращает 2.
MIN(7,2,3)
Возвращает 2.
Советы
Необходимо передать хотя бы один параметр.
POWER
Краткое описание
Возвращает вещественное число, равное числовому значению первого параметра, возведённому в степень, заданную числовым значением второго параметра.
Синтаксис
POWER(X : Number / Numeric_String , Y : Number / Numeric_String) : Number
Примеры использования
POWER(3,2)
Возвращает 9.
POWER(32,0.2)
Возвращает 2.
POWER(16,-0.5)
Возвращает 0.25.
ROUND
Краткое описание
Возвращает целое число, значение которого зависит от числового значения параметра:
- Если это числовое значение целое, возвращается то же самое значение.
- Если это числовое значение не целое, возвращается ближайшее к нему целое число. Положительные числа, находящиеся ровно посередине между соседними целыми числами, округляются upwards, а отрицательные числа, находящиеся ровно посередине между соседними целыми числами, округляются downwards.
Синтаксис
ROUND(X : Number / Numeric_String) : Number
Примеры использования
ROUND(5.0)
Возвращает 5.
ROUND(5.33)
Возвращает 5.
ROUND(5.5)
Возвращает 6 (округление в большую сторону).
ROUND(5.66)
Возвращает 6.
ROUND(-5.0)
Возвращает -5.
ROUND(-5.33)
Возвращает -5.
ROUND(-5.5)
Возвращает -6 (округление в меньшую сторону).
ROUND(-5.66)
Возвращает -6.
SIGN
Краткое описание
Возвращает знак переданного параметра. То есть возвращает целое число, значение которого зависит от числового значения параметра:
- Если это числовое значение положительное, возвращается 1.
- Если это числовое значение отрицательное, возвращается -1.
- Если это числовое значение равно нулю, возвращается 0.
Синтаксис
SIGN(X : Number / Numeric_String) : Number
Примеры использования
SIGN(5.33)
Возвращает 1.
SIGN(-5.33)
Возвращает -1.
SIGN(0)
Возвращает 0.
SQR
Краткое описание
Возвращает вещественное число, равное квадрату числового значения параметра.
Синтаксис
SQR(X : Number / Numeric_String) : Number
Примеры использования
SQR(2)
Возвращает 4.
SQR(14.1)
Возвращает 198.81.
SQR(-1.5)
Возвращает 2.25.
SQRT
Краткое описание
Возвращает вещественное число, равное положительному квадратному корню из числового значения параметра.
Синтаксис
SQRT(X : Number / Numeric_String) : Number
Примеры использования
SQRT(4)
Возвращает 2.
SQRT(10)
Возвращает 3.1623.
TRUNC
Краткое описание
Возвращает целое число, значение которого зависит от числового значения параметра:
- Если это числовое значение положительное, но не целое, возвращается наибольшее целое число, меньшее числового значения параметра.
- Если это числовое значение отрицательное, но не целое, возвращается наименьшее целое число, большее числового значения параметра.
- Если это числовое значение целое, возвращается то же самое значение.
Синтаксис
TRUNC(X : Number / Numeric_String) : Number
Примеры использования
TRUNC(5.0)
Возвращает 5.
TRUNC(5.33)
Возвращает 5.
TRUNC(-5.0)
Возвращает -5.
TRUNC(-5.33)
Возвращает -5.
Советы
Это псевдоним арифметической функции INT.
ZERO
Краткое описание
Возвращает целое число, равное 0 или 1, в зависимости от числового значения параметра. Если это числовое значение равно нулю, возвращается 0; в противном случае возвращается 1.
Синтаксис
ZERO(X : Number / Numeric_String) : Number
Примеры использования
ZERO(5.33)
Возвращает 1.
ZERO(-5.33)
Возвращает 1.
ZERO(0)
Возвращает 0.
Тригонометрические функции
ACOS
Краткое описание
Возвращает вещественное число, равное арккосинусу числового значения параметра; угол выражается в радианах (а не в градусах).
Синтаксис
ACOS(X : Number / Numeric_String) : Number
Примеры использования
ACOS(0)
Возвращает 1.5708.
ACOS(0.5)
Возвращает 1.0472.
ACOS(1)
Возвращает 0.
ASIN
Описание
Возвращает вещественное число, равное арксинусу числового значения параметра; угол выражается в радианах (а не в градусах).
Синтаксис
ASIN(X : Number / Numeric_String) : Number
Примеры использования
ASIN(0)
Возвращает 0.
ASIN(0.5)
Возвращает 0.5236.
ASIN(1)
Возвращает 1.5708.
ATAN
Описание
Возвращает вещественное число, равное арктангенсу числового значения параметра; угол выражается в радианах (а не в градусах).
Синтаксис
ATAN(X : Number / Numeric_String) : Number
Примеры использования
ATAN(0)
Возвращает 0.
ATAN(1)
Возвращает 0.7854.
ATAN(2.5)
Возвращает 1.1903.
COS
Описание
Возвращает вещественное число, равное косинусу угла, заданного числовым значением параметра; угол выражается в радианах (а не в градусах).
Синтаксис
COS(X : Number / Numeric_String) : Number
Примеры использования
COS(0)
Возвращает 1.
COS(0.8)
Возвращает 0.6967.
COS(1.57)
Возвращает 0.0008.
COSH
Описание
Возвращает вещественное число, равное гиперболическому косинусу числового значения параметра.
Синтаксис
COSH(X : Number / Numeric_String) : Number
Примеры использования
COSH(TextHeight / TextWidth) < 70.5
Возвращает объекты, для которых гиперболический косинус отношения TextHeight к TextWidth меньше 70.5. (Это эквивалентно возврату объектов, для которых отношение TextHeight к TextWidth меньше 4.9487).
(TextHeight / TextWidth) >= COSH(2.3)
Возвращает объекты, для которых отношение TextHeight к TextWidth больше или равно гиперболическому косинусу 2.3 (который равен 5.0372).
COTAN
Описание
Возвращает вещественное число, равное котангенсу угла, заданного числовым значением параметра; угол выражается в радианах (а не в градусах).
Синтаксис
COTAN(X : Number / Numeric_String) : Number
Примеры использования
COTAN(0.1)
Возвращает 9.9666.
COTAN(0.8)
Возвращает 0.9712.
COTAN(1.57)
Возвращает 0.0008.
SIN
Описание
Возвращает вещественное число, равное синусу угла, заданного числовым значением параметра; угол выражается в радианах (а не в градусах).
Синтаксис
SIN(X : Number / Numeric_String) : Number
Примеры использования
SIN(0)
Возвращает 0.
SIN(0.8)
Возвращает 0.7174.
SIN(1.57)
Возвращает 1.0.
SINH
Описание
Возвращает вещественное число, равное гиперболическому синусу числового значения параметра.
Синтаксис
SINH(X : Number / Numeric_String) : Number
Примеры использования
SINH(TextWidth / TextHeight) < 0.17
Возвращает объекты, для которых гиперболический синус отношения TextWidth к TextHeight меньше 0.17. (Это эквивалентно возврату объектов, для которых отношение TextWidth к TextHeight меньше 0.1692).
(TextWidth / TextHeight) >= SINH(0.2)
Возвращает объекты, для которых отношение TextWidth к TextHeight больше или равно гиперболическому синусу 0.2 (который равен 0.2013).
TAN
Описание
Возвращает вещественное число, равное тангенсу угла, заданного числовым значением параметра; угол выражается в радианах (а не в градусах).
Синтаксис
TAN(X : Number / Numeric_String) : Number)
Примеры использования
TAN(0)
Возвращает 0.
TAN(0.8)
Возвращает 1.0296.
TAN(1.57)
Возвращает 1255.7656.
TANH
Описание
Возвращает вещественное число, равное гиперболическому тангенсу числового значения параметра.
Синтаксис
TANH(X : Number / Numeric_String) : Number
Примеры использования
TANH(TextWidth / TextHeight) < 0.17
Возвращает объекты, для которых гиперболический тангенс отношения TextWidth к TextHeight меньше 0.17. (Это эквивалентно возврату объектов, для которых отношение TextWidth к TextHeight меньше 0.1717).
(TextWidth / TextHeight) >= TANH(0.2)
Возвращает объекты, для которых отношение TextWidth к TextHeight больше или равно гиперболическому тангенсу 0.2 (который равен 0.1974).
Показательные и логарифмические функции
EXP
Описание
Возвращает вещественное число, равное e в степени, заданной числовым значением параметра. (Число e является основанием натурального логарифма и приблизительно равно 2.7183).
Синтаксис
EXP(X : Number / Numeric_String) : Number
Примеры использования
EXP(0)
Возвращает 1.
EXP(1)
Возвращает 2.7183.
LG
Описание
Возвращает вещественное число, равное десятичному логарифму числового значения параметра.
Синтаксис
LG(X : Number / Numeric_String) : Number
Примеры использования
LG(1)
Возвращает 0.
LG(10)
Возвращает 1.
LG(25)
Возвращает 1.3979.
LN
Описание
Возвращает вещественное число, равное натуральному логарифму (логарифму по основанию e) числового значения параметра. (Число e равно 2.7183).
Синтаксис
LN(X : Number / Numeric_String) : Number
Примеры использования
LN(1)
Возвращает 0.
LN(2)
Возвращает 0.6931.
LN(10)
Возвращает 2.3026.
LOG
Описание
Возвращает вещественное число, равное логарифму по основанию 2 числового значения параметра.
Синтаксис
LOG(X : Number / Numeric_String) : Number
Примеры использования
LOG(1)
Возвращает 0.
LOG(2)
Возвращает 1.
LOG(8)
Возвращает 3.
LOG(10)
Возвращает 3.3219.
Агрегатные функции
AVG
Описание
Возвращает вещественное число, равное среднему значению всех переданных параметров. Каждый параметр должен быть числом или числовой строкой. Можно передать любое количество параметров.
Синтаксис
AVG(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Примеры использования
AVG(2)
Возвращает 2.
AVG(7,2,3)
Возвращает 4.
Советы
- Необходимо передать хотя бы один параметр.
MAX
Описание
Возвращает вещественное число, равное максимальному значению всех переданных параметров. Каждый параметр должен быть числом или числовой строкой. Можно передать любое количество параметров.
Синтаксис
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Примеры использования
MAX(2)
Возвращает 2.
MAX(7,2,3)
Возвращает 7.
Советы
Необходимо передать хотя бы один параметр.
MIN
Описание
Возвращает вещественное число, равное минимальному значению всех переданных параметров. Каждый параметр должен быть числом или числовой строкой. Можно передать любое количество параметров.
Синтаксис
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Примеры использования
MIN(2)
Возвращает 2.
MIN(7,2,3)
Возвращает 2.
Советы
Необходимо передать хотя бы один параметр.
PROD
Описание
Возвращает вещественное число, равное произведению всех переданных параметров. Каждый параметр должен быть числом или числовой строкой. Можно передать любое количество параметров.
Синтаксис
PROD(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Примеры использования
PROD(2)
Возвращает 2.
PROD(7,2,3)
Возвращает 42.
Советы
Необходимо передать хотя бы один параметр.
SUM
Описание
Возвращает вещественное число, равное сумме всех переданных параметров. Каждый параметр должен быть числом или числовой строкой. Можно передать любое количество параметров.
Синтаксис
SUM(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Примеры использования
SUM(2)
Возвращает 2.
SUM(7,2,3)
Возвращает 12.
Советы
Необходимо передать хотя бы один параметр.
Системные функции
Copy
Описание
Возвращает подстроку строки. Можно указать количество символов в возвращаемой подстроке и позицию в исходной строке, с которой она начинается.
Синтаксис
Copy(S : String , Index : Integer , Count : Integer) : String
S — выражение строкового типа. Index и Count — выражения целочисленного типа. Copy возвращает подстроку, содержащую Count символов, начиная с позиции S[Index].
Если Index превышает длину S, Copy возвращает пустую строку.
Если Count задаёт больше символов, чем доступно, возвращаются только символы от S[Index] до конца S.
Примеры использования
Copy('Cats and dogs',1,1)
Возвращает 'C'. (Возвращает 1 символ с 1-й позиции в строке.)
Copy('Cats and dogs',2,1)
Возвращает 'a'. (Возвращает 1 символ со 2-й позиции в строке.)
Copy('Cats and dogs',13,1)
Возвращает 's'. (Возвращает 1 символ с 13-й позиции в строке.)
Copy('Cats and dogs',14,1)
Возвращает '' (пустую строку). (Возвращает 1 символ с 14-й позиции в строке; однако строка содержит всего 13 символов, поэтому возвращается пустая строка.)
Copy('Cats and dogs',1,2)
Возвращает 'Ca'. (Возвращает 2 символа, начиная с 1-й позиции в строке.)
Copy('Cats and dogs',2,2)
Возвращает 'at'. (Возвращает 2 символа, начиная со 2-й позиции в строке.)
Copy('Cats and dogs',12,2)
Возвращает 'gs'. (Возвращает 2 символа, начиная с 12-й позиции в строке.)
Copy('Cats and dogs',13,2)
Возвращает 's'. (Возвращает 2 символа, начиная с 13-й позиции в строке; однако строка содержит всего 13 символов, поэтому возвращается только 1 символ.)
Copy('Cats and dogs',15,2)
Возвращает '' (пустую строку). (Возвращает 2 символа, начиная с 15-й позиции в строке; однако строка содержит всего 13 символов, поэтому возвращается пустая строка.)
Copy('Cats and dogs',1,6)
Возвращает 'Cats a'. (Возвращает 6 символов, начиная с 1-й позиции в строке.)
Copy('Cats and dogs',5,9)
Возвращает ' and dogs'. (Возвращает 9 символов, начиная с 5-й позиции в строке.)
Copy('Cats and dogs',8,5)
Возвращает 'd dog'. (Возвращает 5 символов, начиная с 8-й позиции в строке.)
Copy('Cats and dogs',8,6)
Возвращает 'd dogs'. (Возвращает 6 символов, начиная с 8-й позиции в строке.)
Copy('Cats and dogs',8,7)
Возвращает 'd dogs'. (Возвращает 7 символов, начиная с 8-й позиции в строке; однако строка содержит всего 13 символов, поэтому возвращаются только 6 символов.)
Length
Описание
Возвращает количество символов в строке.
Синтаксис
Length(S : String) : Integer
S — строка, количество символов которой требуется получить.
Примеры использования
Length(Name) Between 4 And 7
Возвращает объекты, у которых значение свойства Name содержит от 4 до 7 символов.
Length('Cat')
Возвращает 3.
Length('Darryll')
Возвращает 7.
Length('Cats and dogs')
Возвращает 13.
Length('')
Возвращает 0.
Pos
Описание
Возвращает индекс первого символа первого вхождения указанной подстроки в заданную строку.
Синтаксис
Pos(Substr : String , S : String) : Integer
Pos ищет подстроку Substr в строке S. Substr и S — выражения строкового типа. Возвращается целочисленное значение, равное индексу первого символа Substr.
Примеры использования
Pos('T',Name) = 1
Возвращает все объекты со свойством Name , в строковом значении которого первое вхождение 'T' находится на первой позиции; примеры таких строк — 'T1' и 'Time Table'. (Символ 'T' встречается в строке 'Time Table' дважды, но первое его вхождение находится на первой позиции.)
Pos('A',Name) = 2
Возвращает все объекты со свойством Name , в строковом значении которого первое вхождение 'A' находится на второй позиции; примеры таких строк — 'RA1' и 'CABLE CHART'.
Pos('B',Name) = 0
Возвращает все объекты, у которых строка, связанная со свойством Name , не содержит 'B' ни в одной позиции; примеры таких строк — 'D1' и 'Time Table'. (Строка 'Time Table' содержит 'b' в восьмой позиции, но функция Pos учитывает регистр.)
Pos('D',Name) > 0
Возвращает все объекты, у которых строка, связанная со свойством Name , содержит 'D' хотя бы в одной позиции в любом месте; примеры таких строк — 'Data Chart', 'U1D' и 'Install either D1 and D2 or D3 and D4, but never install all of these.'.
Pos('Con',Name) = 1
Возвращает все объекты, у которых строка, связанная со свойством Name , впервые содержит 'Con' в первой, второй и третьей позициях; пример такой строки — 'Concatenate'. (Первое вхождение 'Con' в строку 'Concatenate' занимает первые три символа; первый символ в 'Con' — 'C', и он находится в первой позиции строки 'Concatenate'.)
Pos('ate',Name) = 5
Возвращает все объекты, у которых строка, связанная со свойством Name , впервые содержит 'ate' в пятой, шестой и седьмой позициях; пример такой строки — 'Concatenate'. (Первое вхождение 'ate' в строку 'Concatenate' занимает символы с пятого по седьмой; первый символ в 'ate' — 'a', и он находится в пятой позиции строки 'Concatenate'.)
Pos('ate',Name) = 0
Возвращает все объекты, у которых строка, связанная со свойством Name , нигде не содержит 'ate'; примеры таких строк — 'C1' и 'TIME:'.
Pred
Описание
Возвращает вещественное число, равное числовому значению параметра минус 1.0.
Синтаксис
Pred(X : Number / Numeric_String) : Number
Примеры использования
Pred(4.1)
Возвращает 3.1.
Pred(41.313)
Возвращает 40.313.
Random
Описание
Возвращает случайное число в диапазоне от 0 до X-1.
Синтаксис
Random(X) : Number
Примеры использования
Random(10)
Возвращает значение в диапазоне от 0 до 9.
Random(100)
Возвращает значение в диапазоне от 0 до 99.
Succ
Описание
Возвращает вещественное число, равное числовому значению параметра плюс 1.0.
Синтаксис
Succ(X : Number / Numeric_String) : Number
Примеры использования
Succ(2.1)
Возвращает 3.1.
Succ(41.313)
Возвращает 42.313.





















