From OpenSCADAWiki
Jump to: navigation, search

Объект "Виджет" (this)

  • TCntrNodeObj ownerSess( ) — объект сеанса данного виджета.
  • TCntrNodeObj ownerPage( ) — объект родительской страницы данного виджета.
  • TCntrNodeObj ownerWdg( bool base = false ) — объект родительского виджета данного виджета. При указании base будут возвращены и объекты страниц.
  • TCntrNodeObj wdgAdd( string wid, string wname, string parent ) — добавляет виджет wid с именем wname на основе библиотечного виджета parent.
//Добавляет новый виджет на основе виджета текстового примитива
nw = this.wdgAdd("nw", "Новый виджет", "/wlb_originals/wdg_Text");
nw.attrSet("geomX", 50).attrSet("geomY", 50);
  • bool wdgDel( string wid ) — удаляет виджет wid.
  • TCntrNodeObj wdgAt( string wid, bool byPath = false ) — подключается к дочернему или глобальному виджету, посредством пути byPath. В случае глобального подключения можно использовать абсолютный или относительный путь к виджету. Точкой отсчёта абсолютного адреса выступает объект корня модуля "VCAEngine", а значит, первым элементом абсолютного адреса является идентификатор сеанса, который опускается. Относительный адрес берёт отсчёт от текущего виджета. Специальным элементом относительного адреса является элемент вышестоящего узла "..".
  • Array attrList() — перечень атрибутов виджета.
  • bool attrPresent( string attr ) — проверяет атрибут виджета attr на факт присутствия.
  • ElTp attr( string attr, bool fromSess = false ) — значение атрибута виджета attr или из сеанса fromSess. Для отсутствующих атрибутов возвращается пустая строка.
  • TCntrNodeObj attrSet( string attr, ElTp vl, bool toSess = false ) — устанавливает значение vl в атрибут виджета attr или в сеанс, для toSess. Возвращает текущий объект, для конкатенации функций установки.
  • string link( string attr, bool prm = false ) — ссылка атрибута виджета attr. При установке prm запрашивает ссылку группы атрибутов (параметр), представленную указанным атрибутом.
  • string linkSet( string attr, string vl, bool prm = false ) — устанавливает ссылку атрибута виджета attr. При установке prm осуществляется установка ссылки группы атрибутов (параметр), представленной указанным атрибутом.
//Устанавливает ссылку восьмого тренда параметром
this.linkSet("el8.name", "prm:/LogicLev/experiment/Pi", true);
  • string {resource,mime}( string addr, string MIME = "" ) — ресурс объекта по адресу addr (прямая ссылка на ресурс или атрибут виджета с этой ссылкой) с типом MIME, из таблицы сеанса или источника. Предназначено для редактирования ресурса объекта и подстановки его в контексте сеанса, например, изображений SVG.
  • int {resourceSet,mimeSet}( string addr, string data, string MIME = "" ) — устанавливает ресурс объекта в data с типом MIME по адресу addr.
  • int messDebug( string mess ); int messInfo( string mess ); int messNote( string mess ); int messWarning( string mess ); int messErr( string mess ); int messCrit( string mess ); int messAlert( string mess ); int messEmerg( string mess ); — формирует сообщения программы mess с категорией — путь к данному виджету.