]> FormEx

FormEx

1C++ :: </a> </em> </td> <td style="text-align: right;"> <!-- Во второй ячейке пропишем ссылки на следующий/предыдущий топики и оставим возможность в каждом топике добавить свои линки, разместив их в otherlinks. По умолчанию otherlinks отсутствует. --> <subst nodes="chminfo/otherlinks/node()"/> | Ранее: <a href="prev" title="Перейти к предыдущей статье"><title to="prev"/></a> | Далее: <a href="next" title="Перейти к следующей статье"><title to="next"/></a> </td> </tr> <tr> <!-- Вторая строка таблицы будет заголовок топика. Чтобы каждый топик мог при необходимости изменить правило составления заголовка, сделаем здесь subst, а само правило пропишем ниже. Будем брать его из <topictitle> --> <td colspan="2" style="font-size:11pt;font-weight:bold"> <subst nodes="chminfo/topictitle/node()"/> </td> </tr> </table> <!-- А сюда собственно, вставим топик --> <topic/> </decoration> <!-- Основной стиль формирования ссылок на вынесенные топики --> <href> <a href="self"><title to="self"/></a> </href> <!-- Основной принцип объединения ссылок на вынесенные топики --> <hrefcombine> <ul> <foreach> <li><item/></li> </foreach> </ul> </hrefcombine> <!-- Содержимое данного тега подставляется в основной decoration через subst в каждом топике, для формирования заголовка топика. Его можно переопредеделить в топике, для задания другого правила составления заголовка. По умолчанию просто вставляется текст заголовка топика, а сам заголовок удаляется --> <topictitle> <title to="selfremove"/> </topictitle> </maininfo> <!-- Основная разметка для секций "Свойства", "Методы", "События" Задаем другие правила формирования ссылок на вынесенные топики, и объединения ссылок, а также формирования заголовка в дочерних секциях. --> <propsmethods> <!-- Ссылки на вынесенные топики объединим в таблицу --> <hrefcombine> <table border="1" cellspacing="0" cellpadding="3"> <foreach> <tr><item/></tr> </foreach> </table> </hrefcombine> <!-- Зададим разметку потомков, чтобы не писать ее в каждом топике --> <childs> <!-- Формирование ссылки на себя в родительском топике. Сформируем строку таблицы, где первая ячейка - ссылка на топик, а вторая - копия абзаца, в котором есть жирное слово "Описание", но без самого слова "Описание" --> <href> <td style="vertical-align:top"><a class="toc-backref" href="self"><title to="self"/></a></td> <td><subst nodes=".//p[strong='Описание:'][1]/node()[not(name()='strong' and .='Описание:')]"/></td> </href> <!-- Зададим другое правило составления заголовка. Пусть будет "Ссылка на описание объекта::ИмяМетода/Свойства" --> <topictitle> <a class="toc-backref" href="parent[1]" title="Перейти к описанию объекта"><title to="parent[1]"/></a> :: <title to="selfremove"/> </topictitle> <!-- Зададим другой способ задания <html><title> в формируемом файле. Он будет появлятся как имя топика во всех "founded topics" --> <chmtitle> <title to="parent[1]"/>::<title to="self"/> </chmtitle> <!-- Заставим дочерние секции добавлять слова из заголовка в индекс --> <autokw mode="2"/> <!-- На случай, если в описания метода есть еще подсекции, восстановим для них старые правила. --> <insert nodes="//common/maininfo/*[name()='hrefcombine']"/> <childs> <insert nodes="//common/maininfo/*[name()='href']"/> <insert nodes="//common/maininfo/*[name()='topictitle']"/> <chmtitle/> <autokw/> </childs> </childs> </propsmethods> </common></xml><chminfo> <insert nodes="//common/maininfo/*"/> <alinks>_1cpp_formex_</alinks> </chminfo> <hr class="docutils" /> <div class="contents topic"> <p class="topic-title first"><a id="id1" name="id1"><strong>Содержание</strong></a></p> <ul class="simple"> <li><a class="reference" href="#id2" id="id42" name="id42">Раскраска таблиц</a></li> <li><a class="reference" href="#id3" id="id43" name="id43">Раскраска списков значений</a></li> <li><a class="reference" href="#id4" id="id44" name="id44">Предопределенные процедуры</a><ul> <li><a class="reference" href="#id5" id="id45" name="id45">Порядок вызова</a></li> <li><a class="reference" href="#id6" id="id46" name="id46">Глобальные</a><ul> <li><a class="reference" href="#oncreateform" id="id47" name="id47">ПослеСозданияФормы / OnCreateForm</a></li> <li><a class="reference" href="#onrefresh" id="id48" name="id48">ПослеОбновленияФормы / OnRefresh</a></li> <li><a class="reference" href="#onactivate" id="id49" name="id49">ПослеОткрытия / OnActivate</a></li> <li><a class="reference" href="#onclosed" id="id50" name="id50">ПослеЗакрытия / OnClosed</a></li> <li><a class="reference" href="#onmousemove" id="id51" name="id51">ПриДвиженииМыши / OnMouseMove</a></li> <li><a class="reference" href="#onrbuttondown" id="id52" name="id52">ПриНажатииПравойКнопки / OnRButtonDown</a></li> <li><a class="reference" href="#onrbuttonup" id="id53" name="id53">ПриОтжатииПравойКнопки / OnRButtonUp</a></li> <li><a class="reference" href="#onrbuttondblclk" id="id54" name="id54">ПриДвойномНажатииПравойКнопки / OnRButtonDblClk</a></li> <li><a class="reference" href="#onlbuttondown" id="id55" name="id55">ПриНажатииЛевойКнопки / OnLButtonDown</a></li> <li><a class="reference" href="#onlbuttonup" id="id56" name="id56">ПриОтжатииЛевойКнопки / OnLButtonUp</a></li> <li><a class="reference" href="#onlbuttondblclk" id="id57" name="id57">ПриДвойномНажатииЛевойКнопки / OnLButtonDblClk</a></li> <li><a class="reference" href="#onchar" id="id58" name="id58">ПриНажатииКнопкиКлавиатуры / OnChar</a></li> <li><a class="reference" href="#onsize" id="id59" name="id59">ПриИзмененииРазмераОкна / OnSize</a></li> <li><a class="reference" href="#multilinepic" id="id60" name="id60">ПиктограммаМногострочнойЧасти / MultiLinePic</a></li> <li><a class="reference" href="#id7" id="id61" name="id61">ПриЗагрузкеФормы</a></li> <li><a class="reference" href="#id8" id="id62" name="id62">ПриЗагрузкеМодуляФормы</a></li> <li><a class="reference" href="#onloadasexternalform" id="id63" name="id63">ПриЗагрузкеВнешнегоОтчета / OnLoadAsExternalForm</a></li> </ul> </li> <li><a class="reference" href="#id9" id="id64" name="id64">Локальные</a><ul> <li><a class="reference" href="#id10" id="id65" name="id65">ПослеСозданияФормы / OnCreateForm</a></li> <li><a class="reference" href="#id11" id="id66" name="id66">ПослеОбновленияФормы / OnRefresh</a></li> <li><a class="reference" href="#id12" id="id67" name="id67">ПослеОткрытия / OnActivate</a></li> <li><a class="reference" href="#id13" id="id68" name="id68">ПослеЗакрытия / OnClosed</a></li> <li><a class="reference" href="#id14" id="id69" name="id69">ПриДвиженииМыши / OnMouseMove</a></li> <li><a class="reference" href="#id15" id="id70" name="id70">ПриНажатииПравойКнопки / OnRButtonDown</a></li> <li><a class="reference" href="#id16" id="id71" name="id71">ПриОтжатииПравойКнопки / OnRButtonUp</a></li> <li><a class="reference" href="#id17" id="id72" name="id72">ПриДвойномНажатииПравойКнопки / OnRButtonDblClk</a></li> <li><a class="reference" href="#id18" id="id73" name="id73">ПриНажатииЛевойКнопки / OnLButtonDown</a></li> <li><a class="reference" href="#id19" id="id74" name="id74">ПриОтжатииЛевойКнопки / OnLButtonUp</a></li> <li><a class="reference" href="#id20" id="id75" name="id75">ПриДвойномНажатииЛевойКнопки / OnLButtonDblClk</a></li> <li><a class="reference" href="#id21" id="id76" name="id76">ПриНажатииКнопкиКлавиатуры / OnChar</a></li> <li><a class="reference" href="#id22" id="id77" name="id77">ПриИзмененииРазмераОкна / OnSize</a></li> <li><a class="reference" href="#id23" id="id78" name="id78">ПиктограммаМногострочнойЧасти / MultiLinePic</a></li> </ul> </li> <li><a class="reference" href="#id24" id="id79" name="id79">Локальные (для обработки событий объекта "Дерево+Таблица")</a><ul> <li><a class="reference" href="#onitemexpanding" id="id80" name="id80">ПриРазворачиванииУзла / OnItemExpanding</a></li> <li><a class="reference" href="#onitemexpanded" id="id81" name="id81">ПослеРазворачиванияУзла / OnItemExpanded</a></li> <li><a class="reference" href="#onitemcollapsing" id="id82" name="id82">ПриСворачиванииУзла / OnItemCollapsing</a></li> <li><a class="reference" href="#onitemcollapsed" id="id83" name="id83">ПослеСворачиванияУзла / OnItemCollapsed</a></li> <li><a class="reference" href="#onlbuttonovertree" id="id84" name="id84">ПриНажатииЛевойКнопкиНадДеревом / OnLButtonOverTree</a></li> <li><a class="reference" href="#onrbuttonovertree" id="id85" name="id85">ПриНажатииПравойКнопкиНадДеревом / OnRButtonOverTree</a></li> </ul> </li> </ul> </li> <li><a class="reference" href="#table" id="id86" name="id86">Объект Таблица / Table (доработка стандартного объекта)</a><ul> <li><a class="reference" href="#id25" id="id87" name="id87">Методы</a><ul> <li><a class="reference" href="#sourcetable" id="id88" name="id88">ИсходнаяТаблица / SourceTable</a></li> <li><a class="reference" href="#options" id="id89" name="id89">Опции / Options</a></li> </ul> </li> </ul> </li> <li><a class="reference" href="#service" id="id90" name="id90">Объект Сервис / Service</a><ul> <li><a class="reference" href="#id26" id="id91" name="id91">Методы</a><ul> <li><a class="reference" href="#colourbrowse" id="id92" name="id92">ВключитьРаскраскуТаблиц / ColourBrowse</a></li> <li><a class="reference" href="#uncolourbrowse" id="id93" name="id93">ВыключитьРаскраскуТаблиц / UnColourBrowse</a></li> <li><a class="reference" href="#activecontext" id="id94" name="id94">АктивныйКонтекст / ActiveContext</a></li> <li><a class="reference" href="#callasprocedure" id="id95" name="id95">ВыполнитьПроцедуру / CallAsProcedure</a></li> <li><a class="reference" href="#callasfunction" id="id96" name="id96">ВыполнитьФункцию / CallAsFunction</a></li> <li><a class="reference" href="#getcontextvar" id="id97" name="id97">ПолучитьПеременнуюКонтекста / GetContextVar</a></li> <li><a class="reference" href="#setcontextvar" id="id98" name="id98">УстановитьПеременнуюКонтекста / SetContextVar</a></li> <li><a class="reference" href="#choosevalue" id="id99" name="id99">ВыбратьЗначение / ChooseValue</a></li> <li><a class="reference" href="#addglobalmodule" id="id100" name="id100">ДобавитьГлобальныйМодуль / AddGlobalModule</a></li> <li><a class="reference" href="#deleteglobalmodule" id="id101" name="id101">УдалитьГлобальныйМодуль / DeleteGlobalModule</a></li> <li><a class="reference" href="#showkeyboardindicator" id="id102" name="id102">ПоказыватьИндикаторКлавиатуры / ShowKeyboardIndicator</a></li> <li><a class="reference" href="#setwallpaper" id="id103" name="id103">УстановитьОбои / SetWallpaper</a></li> <li><a class="reference" href="#heighttablestring" id="id104" name="id104">ВысотаСтрокиТаблицы / HeightTableString</a></li> <li><a class="reference" href="#hidetable" id="id105" name="id105">ПрятатьТаблицу / HideTable</a></li> <li><a class="reference" href="#idleprocessing" id="id106" name="id106">ОбработкаОжидания / IdleProcessing</a></li> <li><a class="reference" href="#commandline" id="id107" name="id107">КоманднаяСтрока / CommandLine</a></li> <li><a class="reference" href="#gettablenames" id="id108" name="id108">ПолучитьИменаТаблицы / GetTableNames</a></li> <li><a class="reference" href="#osversion" id="id109" name="id109">ВерсияОС / OSVersion</a></li> <li><a class="reference" href="#getprinterslist" id="id110" name="id110">ПолучитьСписокПринтеров / GetPrintersList</a></li> <li><a class="reference" href="#isprinterready" id="id111" name="id111">ГотовностьПринтера / IsPrinterReady</a></li> <li><a class="reference" href="#play" id="id112" name="id112">Воспроизвести / Play</a></li> <li><a class="reference" href="#listmoxel" id="id113" name="id113">СписокТаблиц / ListMoxel</a></li> <li><a class="reference" href="#setcurcor" id="id114" name="id114">УстановитьКурсор / SetCurcor</a></li> <li><a class="reference" href="#sendkeys" id="id115" name="id115">ЭмулироватьКлавиатуру / SendKeys</a></li> <li><a class="reference" href="#createfont" id="id116" name="id116">СоздатьШрифт / CreateFont</a></li> <li><a class="reference" href="#createfontcausedby" id="id117" name="id117">СоздатьШрифтНаОсновании / CreateFontCausedBy</a></li> <li><a class="reference" href="#deletefont" id="id118" name="id118">УдалитьШрифт / DeleteFont</a></li> <li><a class="reference" href="#guid-getguid" id="id119" name="id119">ПолучитьGUID / GetGUID</a></li> <li><a class="reference" href="#formex-versionformex" id="id120" name="id120">ВерсияFormEx / VersionFormEx</a></li> <li><a class="reference" href="#asyncevent" id="id121" name="id121">ВнешнееСобытие / AsyncEvent</a></li> <li><a class="reference" href="#mousehook" id="id122" name="id122">ПерехватМыши / MouseHook</a></li> <li><a class="reference" href="#keyhook" id="id123" name="id123">ПерехватКлавиатуры / KeyHook</a></li> <li><a class="reference" href="#valuelistdraw" id="id124" name="id124">ПерехватОтрисовкиСписков / ValueListDraw</a></li> <li><a class="reference" href="#allformslist" id="id125" name="id125">СписокВсехФорм / AllFormsList</a></li> <li><a class="reference" href="#opentoolsform" id="id126" name="id126">ОткрытьПлавающуюФорму / OpenToolsForm</a></li> </ul> </li> </ul> </li> <li><a class="reference" href="#id27" id="id127" name="id127">Объект РасширениеФормы / FormEx</a><ul> <li><a class="reference" href="#id28" id="id128" name="id128">Свойства</a><ul> <li><a class="reference" href="#attribute" id="id129" name="id129"><АтрибутФормы> / <Attribute></a></li> <li><a class="reference" href="#top" id="id130" name="id130">Верх / Top</a></li> <li><a class="reference" href="#left" id="id131" name="id131">Лево / Left</a></li> <li><a class="reference" href="#height" id="id132" name="id132">Высота / Height</a></li> <li><a class="reference" href="#width" id="id133" name="id133">Ширина / Width</a></li> <li><a class="reference" href="#maximize" id="id134" name="id134">Максимизирована / Maximize</a></li> <li><a class="reference" href="#minimize" id="id135" name="id135">Минимизирована / Minimize</a></li> <li><a class="reference" href="#label" id="id136" name="id136">Метка / Label</a></li> <li><a class="reference" href="#bkcolor" id="id137" name="id137">ЦветФона / BkColor</a></li> <li><a class="reference" href="#description" id="id138" name="id138">Описание / Description</a></li> <li><a class="reference" href="#moduletext" id="id139" name="id139">ТекстМодуля / ModuleText</a></li> <li><a class="reference" href="#transparency" id="id140" name="id140">Прозрачность / Transparency</a></li> </ul> </li> <li><a class="reference" href="#id29" id="id141" name="id141">Методы</a><ul> <li><a class="reference" href="#assignform" id="id142" name="id142">УстановитьФорму / AssignForm</a></li> <li><a class="reference" href="#getform" id="id143" name="id143">ПолучитьФорму / GetForm</a></li> <li><a class="reference" href="#getnumattrib" id="id144" name="id144">КоличествоАтрибутов / GetNumAttrib</a></li> <li><a class="reference" href="#getattrib" id="id145" name="id145">ПолучитьАтрибут / GetAttrib</a></li> <li><a class="reference" href="#fullpath" id="id146" name="id146">ПолныйПуть / FullPath</a></li> <li><a class="reference" href="#objecttype" id="id147" name="id147">ТипОбъекта / ObjectType</a></li> <li><a class="reference" href="#fullobjecttype" id="id148" name="id148">ПолныйТипОбъекта / FullObjectType</a></li> <li><a class="reference" href="#fixmultiline" id="id149" name="id149">ФиксироватьМногострочнуюЧасть / FixMultiLine</a></li> <li><a class="reference" href="#addattrib" id="id150" name="id150">ДобавитьАтрибут / AddAttrib</a></li> <li><a class="reference" href="#getattribatpos" id="id151" name="id151">ПолучитьАтрибутПоКоординатам / GetAttribAtPos</a></li> <li><a class="reference" href="#findattrib" id="id152" name="id152">НайтиАтрибут / FindAttrib</a></li> <li><a class="reference" href="#getnextattrib" id="id153" name="id153">ПолучитьСледующийАтрибут / GetNextAttrib</a></li> <li><a class="reference" href="#currentattrib" id="id154" name="id154">ТекущийАтрибут / CurrentAttrib</a></li> <li><a class="reference" href="#getpicture" id="id155" name="id155">ПолучитьКартинку / GetPicture</a></li> <li><a class="reference" href="#highlighttabitem" id="id156" name="id156">ПодсветкаЗакладки / HighlightTabItem</a></li> <li><a class="reference" href="#addtabimages" id="id157" name="id157">ДобавитьКартинкиЗакладок / AddTabImages</a></li> <li><a class="reference" href="#refreshtabimages" id="id158" name="id158">ОбновитьКартинкиЗакладок / RefreshTabImages</a></li> <li><a class="reference" href="#disablecloseformbybutton" id="id159" name="id159">ЗапретЗакрытияФормыКнопкой / DisableCloseFormByButton</a></li> <li><a class="reference" href="#refresh" id="id160" name="id160">Обновить / Refresh</a></li> <li><a class="reference" href="#colourtable" id="id161" name="id161">РаскрашиватьТаблицу / ColourTable</a></li> <li><a class="reference" href="#attachform" id="id162" name="id162">ПрисоединитьФорму / AttachForm</a></li> <li><a class="reference" href="#detachform" id="id163" name="id163">ОтсоединитьФорму / DetachForm</a></li> <li><a class="reference" href="#tablecolumnposition" id="id164" name="id164">ПоложениеКолонкиТаблицы / TableColumnPosition</a></li> <li><a class="reference" href="#setautoadjusttable" id="id165" name="id165">УстановитьАвтоширинуВТаблице / SetAutoAdjustTable</a></li> <li><a class="reference" href="#resetmodify" id="id166" name="id166">СбросМодифицированности / ResetModify</a></li> <li><a class="reference" href="#id30" id="id167" name="id167">УстановитьКурсор / SetCurcor</a></li> <li><a class="reference" href="#gettablesname" id="id168" name="id168">ПолучитьИменаТаблиц / GetTablesName</a></li> <li><a class="reference" href="#setcolumnwidth" id="id169" name="id169">УстановитьШиринуКолонки / SetColumnWidth</a></li> <li><a class="reference" href="#getcolumnwidth" id="id170" name="id170">ПолучитьШиринуКолонки / GetColumnWidth</a></li> <li><a class="reference" href="#getcurrentcellcoordinates" id="id171" name="id171">ПолучитьКоординатыТекущейЯчейки / GetCurrentCellCoordinates</a></li> <li><a class="reference" href="#getcellcoordinates" id="id172" name="id172">ПолучитьКоординатыЯчейки / GetCellCoordinates</a></li> <li><a class="reference" href="#id31" id="id173" name="id173">ОбработкаОжидания / IdleProcessing</a></li> <li><a class="reference" href="#settablepicture" id="id174" name="id174">УстановитьКартинкуМногострочнойЧасти / SetTablePicture</a></li> </ul> </li> </ul> </li> <li><a class="reference" href="#attribex" id="id175" name="id175">Объект АтрибутФормы / AttribEx</a><ul> <li><a class="reference" href="#id32" id="id176" name="id176">Свойства</a><ul> <li><a class="reference" href="#caption" id="id177" name="id177">Заголовок / Caption</a></li> <li><a class="reference" href="#hint" id="id178" name="id178">Подсказка / Hint</a></li> <li><a class="reference" href="#id33" id="id179" name="id179">Описание / Description</a></li> <li><a class="reference" href="#formula" id="id180" name="id180">Формула / Formula</a></li> <li><a class="reference" href="#visible" id="id181" name="id181">Видимость / Visible</a></li> <li><a class="reference" href="#readonly" id="id182" name="id182">Доступность / ReadOnly</a></li> <li><a class="reference" href="#layer" id="id183" name="id183">Слой / Layer</a></li> <li><a class="reference" href="#type" id="id184" name="id184">Тип / Type</a></li> <li><a class="reference" href="#attribid" id="id185" name="id185">Идентификатор / AttribID</a></li> <li><a class="reference" href="#value" id="id186" name="id186">Значение / Value</a></li> <li><a class="reference" href="#id34" id="id187" name="id187">ЦветФона / BkColor</a></li> <li><a class="reference" href="#fontcolor" id="id188" name="id188">ЦветШрифта / FontColor</a></li> <li><a class="reference" href="#mask" id="id189" name="id189">Маска / Mask</a></li> <li><a class="reference" href="#related" id="id190" name="id190">СвязанС / Related</a></li> <li><a class="reference" href="#font" id="id191" name="id191">Шрифт / Font</a></li> <li><a class="reference" href="#class" id="id192" name="id192">Класс / Class</a></li> <li><a class="reference" href="#border" id="id193" name="id193">Рамка / Border</a></li> <li><a class="reference" href="#parentwindow" id="id194" name="id194">РодительскоеОкно / ParentWindow</a></li> <li><a class="reference" href="#handle" id="id195" name="id195">Дескриптор / Handle</a></li> </ul> </li> <li><a class="reference" href="#id35" id="id196" name="id196">Методы (для работы с объектом "Дерево+Таблица")</a><ul> <li><a class="reference" href="#wrapvaluetable" id="id197" name="id197">ПерехватитьТаблицуЗначений / WrapValueTable</a></li> <li><a class="reference" href="#updatetree" id="id198" name="id198">ОбновитьДерево / UpdateTree</a></li> <li><a class="reference" href="#currenttreeitem" id="id199" name="id199">ТекущаяСтрокаДерева / CurrentTreeItem</a></li> <li><a class="reference" href="#currenttreecolumn" id="id200" name="id200">ТекущаяКолонкаДерева / CurrentTreeColumn</a></li> <li><a class="reference" href="#valuefromtree" id="id201" name="id201">ЗначениеИзДерева / ValueFromTree</a></li> <li><a class="reference" href="#valuetotree" id="id202" name="id202">ЗначениеВДерево / ValueToTree</a></li> <li><a class="reference" href="#expandnode" id="id203" name="id203">РазвернутьУзел / ExpandNode</a></li> <li><a class="reference" href="#collapsenode" id="id204" name="id204">СвернутьУзел / CollapseNode</a></li> <li><a class="reference" href="#isgroupnode" id="id205" name="id205">ЭтоГруппа / IsGroupNode</a></li> <li><a class="reference" href="#setcurrentnode" id="id206" name="id206">УстановитьТекущийУзел / SetCurrentNode</a></li> <li><a class="reference" href="#treecolumnname" id="id207" name="id207">ИдентификаторКолонкиДерева / TreeColumnName</a></li> <li><a class="reference" href="#getvaluetablecolumnnum" id="id208" name="id208">ПолучитьНомерКолонкиТаблицыЗначений / GetValueTableColumnNum</a></li> <li><a class="reference" href="#treeoptions" id="id209" name="id209">ОпцииДерева / TreeOptions</a></li> </ul> </li> <li><a class="reference" href="#id36" id="id210" name="id210">Методы</a><ul> <li><a class="reference" href="#assignattrib" id="id211" name="id211">УстановитьАтрибут / AssignAttrib</a></li> <li><a class="reference" href="#id37" id="id212" name="id212">ПолучитьФорму / GetForm</a></li> <li><a class="reference" href="#valuetypestr" id="id213" name="id213">ТипЗначенияСтр / ValueTypeStr</a></li> <li><a class="reference" href="#getcoordinates" id="id214" name="id214">ПолучитьКоординаты / GetCoordinates</a></li> <li><a class="reference" href="#setcoordinates" id="id215" name="id215">УстановитьКоординаты / SetCoordinates</a></li> <li><a class="reference" href="#wrapvaluelist" id="id216" name="id216">ПерехватитьСписокЗначений / WrapValueList</a></li> <li><a class="reference" href="#id38" id="id217" name="id217">УстановитьКурсор / SetCurcor</a></li> <li><a class="reference" href="#createcontrol" id="id218" name="id218">СоздатьЭлементУправления / CreateControl</a></li> </ul> </li> </ul> </li> <li><a class="reference" href="#windows" id="id219" name="id219">Объект Окна / Windows</a><ul> <li><a class="reference" href="#id39" id="id220" name="id220">Методы</a><ul> <li><a class="reference" href="#getmenu" id="id221" name="id221">ПолучитьМеню / GetMenu</a></li> <li><a class="reference" href="#enablemenu" id="id222" name="id222">ДоступностьМеню / EnableMenu</a></li> <li><a class="reference" href="#visiblemenu" id="id223" name="id223">ВидимостьМеню / VisibleMenu</a></li> <li><a class="reference" href="#gettoolbars" id="id224" name="id224">ПолучитьПанели / GetToolBars</a></li> <li><a class="reference" href="#showtoolbar" id="id225" name="id225">ПоказыватьПанель / ShowToolBar</a></li> <li><a class="reference" href="#showtoolbars" id="id226" name="id226">ПоказыватьПанели / ShowToolBars</a></li> <li><a class="reference" href="#showstatusbar" id="id227" name="id227">ПоказыватьСтрокуСостояния / ShowStatusBar</a></li> <li><a class="reference" href="#windowsstyle" id="id228" name="id228">СтильОкна / WindowsStyle</a></li> <li><a class="reference" href="#windowssize" id="id229" name="id229">РазмерОкна / WindowsSize</a></li> <li><a class="reference" href="#windowspos" id="id230" name="id230">ПоложениеОкна / WindowsPos</a></li> <li><a class="reference" href="#windowsmenu" id="id231" name="id231">МенюОкна / WindowsMenu</a></li> <li><a class="reference" href="#centerwindow" id="id232" name="id232">ЦентрироватьОкно / CenterWindow</a></li> <li><a class="reference" href="#id40" id="id233" name="id233">Максимизировать / Maximize</a></li> <li><a class="reference" href="#id41" id="id234" name="id234">Минимизировать / Minimize</a></li> <li><a class="reference" href="#restore" id="id235" name="id235">Восстановить / Restore</a></li> <li><a class="reference" href="#getresolution" id="id236" name="id236">ПолучитьРазрешение / GetResolution</a></li> <li><a class="reference" href="#bringwindowtotop" id="id237" name="id237">НаПереднийПлан / BringWindowToTop</a></li> <li><a class="reference" href="#beginmodalstate" id="id238" name="id238">ВключитьМодальныйРежим / BeginModalState</a></li> <li><a class="reference" href="#endmodalstate" id="id239" name="id239">ВыключитьМодальныйРежим / EndModalState</a></li> <li><a class="reference" href="#minimizetotray" id="id240" name="id240">МинимизироватьВТрей / MinimizeToTray</a></li> </ul> </li> </ul> </li> </ul> </div> <hr class="docutils" /> <div class="section"> <h1><a class="toc-backref" href="#id42" id="id2" name="id2">Раскраска таблиц</a></h1> <p>Компонента позволяет устанавливать произвольную раскраску в таблицах 1С (многострочные части документов, формы списков, таблицы значений на форме и т.д.).</p> <p>Разрешить раскраску таблиц можно с помощью метода <a class="reference" href="#colourbrowse">ВключитьРаскраскуТаблиц / ColourBrowse</a> или с помощью флажка на странице свойств компоненты. Запрет раскраски производится вызовом метода <a class="reference" href="#uncolourbrowse">ВыключитьРаскраскуТаблиц / UnColourBrowse</a> или снятием флажка на странице свойств.</p> <p>Для включения раскраски в таблицу необходимо добавить колонку, формула в которой должна содержать служебную строку. В общем случае колонка должна располагаться левее колонок, которые предполагается раскрасить.</p> <p>Служебная строка может быть, как напрямую прописана в формуле колонки (или формироваться функцией, вызываемой из формулы), так и быть содержимым реквизита. Для таблиц значений строка раскраски устанавливается в качестве значения ячейки таблицы. Служебная строка состоит из макрокоманд, которые формируют стиль строки. Макрокоманды регистронезависимы и могут располагаться в любой последовательности. Ни одна из макрокоманд не является обязательной, т.е. любая из них может быть опущена при формировании служебной строки.</p> <dl class="docutils"> <dt><strong>Макрокоманды:</strong></dt> <dd><div class="first last line-block"> <div class="line">FONT[<Цвет>] - задает цвет шрифта строки;</div> <div class="line">BRUSH[<Цвет>] - задает цвет фона строки;</div> <div class="line">FONT_S[<Цвет>] - задает цвет шрифта строки, если она является текущей (не влияет на текущую ячейку);</div> <div class="line">BRUSH_S[<Цвет>] - задает цвет фона строки, если она является текущей (не влияет на текущую ячейку);</div> <div class="line">COUNT[<КоличествоКолонок>] - задает количество колонок, на которые распространяется раскраска;</div> <div class="line">INDENT[<Отступ>] - задает количество колонок, которое необходимо пропустить перед началом раскраски;</div> <div class="line">FONTSET[<КодШрифта>] - задает шрифт строки;</div> <div class="line">FONTSET_S[<КодШрифта>] - задает шрифт строки, если она является текущей;</div> </div> </dd> <dt><strong>Параметры макрокоманд:</strong></dt> <dd><div class="first last line-block"> <div class="line"><Цвет> - представление необходимого цвета в формате RGB в виде положительного числа. Может быть как десятеричным, так и шестнадцатеричным (в этом случае необходимо добавить "0x" перед числом).</div> <div class="line"><КоличествоКолонок> - положительное число.</div> <div class="line"><Отступ> - положительное или отрицательное число.</div> <div class="line"><КодШрифта> - код пользовательского шрифта, возвращенный методом <a class="reference" href="#createfont">СоздатьШрифт / CreateFont</a>.</div> </div> </dd> </dl> <p>Вместо любого из параметров можно написать строку <tt class="docutils literal"><span class="pre">NONE</span></tt>, тогда соответствующая макрокоманда применит текущую системную настройку. Если Отступ задан отрицательным числом, то КоличествоКолонок считает только видимые колонки до текущей колонки со служебной строкой. После текущей строки (или если Отступ >=0) КоличествоКолонок считает как видимые, так и невидимые колонки.</p> <p>Служебная строка с макрокомандами действует только в пределах одной строки. Макрокоманды FONT, FONT_S, BRUSH, BRUSH_S, FONTSET и FONTSET_S сбрасывают значения макрокоманд COUNT и INDENT, заданные предыдущей служебной строкой, к нулевому состоянию. Макрокоманда COUNT сбрасывает значение макрокоманды INDENT, заданное предыдущей служебной строкой, к нулевому состоянию.</p> <p>Флаг "Отрицательное красным" игнорируется в раскрашиваемых колонках.</p> </div> <div class="section"> <h1><a class="toc-backref" href="#id43" id="id3" name="id3">Раскраска списков значений</a></h1> <p>Раскраска списков значений (список значений на форме, поле с выпадающим списком) так же реализована с помощью макрокоманд (подробнее см. <a class="reference" href="#id2">Раскраска таблиц</a>).</p> <p>Разрешить или запретить раскраску списков значений можно с помощью метода <a class="reference" href="#valuelistdraw">ПерехватОтрисовкиСписков / ValueListDraw</a>.</p> <p>Служебная строка макрокоманд должен размещаться в представлении раскрашиваемой позиции списка значений. Для того чтобы сделать макрокоманды невидимым пользователю, рекомендуется помещать служебную строку в представление второй строкой, т.е. перед списком макрокоманд поставить разделитель строк.</p> <dl class="docutils"> <dt><strong>Макрокоманды:</strong></dt> <dd><div class="first last line-block"> <div class="line">FONT[<Цвет>] - задает цвет шрифта строки;</div> <div class="line">BRUSH[<Цвет>] - задает цвет фона строки;</div> <div class="line">FONT_S[<Цвет>] - задает цвет шрифта строки, если она является текущей (не влияет на текущую ячейку);</div> <div class="line">BRUSH_S[<Цвет>] - задает цвет фона строки, если она является текущей (не влияет на текущую ячейку);</div> <div class="line">FONTSET[<КодШрифта>] - задает шрифт строки;</div> <div class="line">FONTSET_S[<КодШрифта>] - задает шрифт строки, если она является текущей;</div> <div class="line">IMAGE[<ИмяКартинки>] - задает пользовательское начертание флажков в списке с пометками;</div> </div> </dd> <dt><strong>Параметры макрокоманд:</strong></dt> <dd><div class="first last line-block"> <div class="line"><Цвет> - представление необходимого цвета в формате RGB в виде положительного числа. Может быть как десятеричным, так и шестнадцатеричным (в этом случае необходимо добавить "0x" перед числом).</div> <div class="line"><ИмяКартинки> - идентификатор картинки в библиотеке картинок, содержащей пользовательское представление флажков для списка с пометками. Картинка должна состоять из двух пиктограмм размером 13х16 (ширина х высота): первая - непомеченная строка списка; вторая - помеченная строка списка.</div> <div class="line"><КодШрифта> - код пользовательского шрифта, возвращенный методом <a class="reference" href="#createfont">СоздатьШрифт / CreateFont</a>.</div> </div> </dd> </dl> <p><strong>Пример:</strong></p> <pre class="literal-block"> Раскраска = "FONT[" + ПолучитьЦвет(0,0,0) + "]" + "BRUSH[" + ПолучитьЦвет(100,255,100) + "]" + "FONTSET[" + глШрифт2 + "]"+ "FONTSET_S[" + глШрифт1 + "]"+ "BRUSH_S["+ПолучитьЦвет(0,100,100)+"]"; Список.ДобавитьЗначение(зн, ""+зн+РазделительСтрок+Раскраска); </pre> </div> <div class="section"> <h1><a class="toc-backref" href="#id44" id="id4" name="id4">Предопределенные процедуры</a></h1> <div class="section"> <h2><a class="toc-backref" href="#id45" id="id5" name="id5">Порядок вызова</a></h2> <p>Первоначально предопределенная процедура ищется в модуле активной формы.</p> <p>Если процедура присутствует в модуле формы, то она вызывается. В противном случае процедура ищется во всех загруженных глобальных модулях, в порядке их загрузки, начиная с основного глобального модуля.</p> <p>Вызов дополнительных предопределенных процедур сквозной. Т.е. не останавливается после первой найденной процедуры, а идет дальше, через локальный контекст, основной глобальный модуль и все дополнительный глобальные модули.</p> <p><strong>Порядок поиска процедуры по имени:</strong></p> <blockquote> <div class="line-block"> <div class="line">Процедура <РусскоеИмяПроцедуры></div> <div class="line">Процедура <АнглийскоеИмяПроцедуры></div> <div class="line">Функция <РусскоеИмяПроцедуры></div> <div class="line">Функция <АнглийскоеИмяПроцедуры></div> </div> </blockquote> </div> <div class="section"> <h2><a class="toc-backref" href="#id46" id="id6" name="id6">Глобальные</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id47" id="oncreateform" name="oncreateform">ПослеСозданияФормы / OnCreateForm</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеСозданияФормы(Контекст)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст открытой формы</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается после физического создания окна формы в системе, когда окно формы создано, но еще не полностью проинициализоровано и не отображено на экране. В этой процедуре (и во всех процедурах, вызываемых после нее) можно вызывать методы, которые помечены как <em>"работает только после физического открытия окна формы"</em>.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПослеСозданияФормы(Конт) ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.УстановитьФорму(Конт.Форма); ФормаРасш.ФиксироватьМногострочнуюЧасть(2); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id48" id="onrefresh" name="onrefresh">ПослеОбновленияФормы / OnRefresh</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеОбновленияФормы(Контекст)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст обновленной формы</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при обновлении формы, после выполнения форму текстовых реквизитов формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПослеОбновленияФормы(Конт) Состояние("Обновление формы!"); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id49" id="onactivate" name="onactivate">ПослеОткрытия / OnActivate</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеОткрытия(Контекст)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст открытой формы</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается после физического создания окна формы в системе, когда окно формы создано, полностью проинициализировано и отображено на экране.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПослеОткрытия(Конт) ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.УстановитьФорму(Конт.Форма); ФормаРасш.ФиксироватьМногострочнуюЧасть(2); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id50" id="onclosed" name="onclosed">ПослеЗакрытия / OnClosed</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеЗакрытия(Контекст)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст закрытой формы</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается после физического разрушения окна формы. Предотвратить закрытие окна в этой процедуре невозможно.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПослеЗакрытия(Конт) глЗаписатьСтрокуЛога(Конт); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id51" id="onmousemove" name="onmousemove">ПриДвиженииМыши / OnMouseMove</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриДвиженииМыши(Контекст, Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается движения мыши поверх формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвиженииМыши(конт, сост, х, у) Состояние(" х = " + х + " у = " + у + " сост = " + сост); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id52" id="onrbuttondown" name="onrbuttondown">ПриНажатииПравойКнопки / OnRButtonDown</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриНажатииПравойКнопки(Контекст, Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при нажатии правой кнопки мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриНажатииПравойКнопки(конт, сост, х, у) Сообщить("Нажата правая кнопка мыши."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id53" id="onrbuttonup" name="onrbuttonup">ПриОтжатииПравойКнопки / OnRButtonUp</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриОтжатииПравойКнопки(Контекст, Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается когда отпущена правая кнопка мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриОтжатииПравойКнопки(конт, сост, х, у) Сообщить("Отпущена правая кнопка мыши."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id54" id="onrbuttondblclk" name="onrbuttondblclk">ПриДвойномНажатииПравойКнопки / OnRButtonDblClk</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриДвойномНажатииПравойКнопки(Контекст, Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при двойном клике правой кнопкой мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвойномНажатииПравойКнопки(конт, сост, х, у) Предупреждение("Двойной правый клик по форме."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id55" id="onlbuttondown" name="onlbuttondown">ПриНажатииЛевойКнопки / OnLButtonDown</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриНажатииЛевойКнопки(Контекст, Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при нажатии левой кнопки мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриНажатииЛевойКнопки(конт, сост, х, у) Сообщить("Нажата левая кнопка мыши."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id56" id="onlbuttonup" name="onlbuttonup">ПриОтжатииЛевойКнопки / OnLButtonUp</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриОтжатииЛевойКнопки(Контекст, Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается когда отпущена левая кнопка мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриОтжатииЛевойКнопки(конт, сост, х, у) Сообщить("Отпущена левая кнопка мыши."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id57" id="onlbuttondblclk" name="onlbuttondblclk">ПриДвойномНажатииЛевойКнопки / OnLButtonDblClk</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриДвойномНажатииЛевойКнопки(Контекст, Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при двойном клике левой кнопкой мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвойномНажатииЛевойКнопки(конт, сост, х, у) Предупреждение("Двойной левый клик по форме."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id58" id="onchar" name="onchar">ПриНажатииКнопкиКлавиатуры / OnChar</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриНажатииКнопкиКлавиатуры(Контекст, КодКлавиши, Alt, Shift, Ctrl, Символ, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>КодКлавиши - код нажатой кнопки клавиатуры.</li> <li>Alt - флаг нажатия кнопки <Alt>.</li> <li>Shift - флаг нажатия кнопки <Shift>.</li> <li>Ctrl - флаг нажатия кнопки <Ctrl>.</li> <li>Символ - символ нажатой кнопки в формате ASCII.</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при нажатии кнопки клавиатуры.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриНажатииКнопкиКлавиатуры(конт, код, _а, _ш, _к) Предупреждение("Нажата кнопка клавиатуры."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id59" id="onsize" name="onsize">ПриИзмененииРазмераОкна / OnSize</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриИзмененииРазмераОкна(Контекст, ТипСобытия, Ширина, Высота)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last"> <li><p class="first">Контекст - контекст формы</p> </li> <li><dl class="first docutils"> <dt>ТипСобытия - определяет тип запрошенного изменения размеров. Этот параметр может принимать одно из следующих значений:</dt> <dd><ul class="first last simple"> <li>0 - Окно было изменено, но без минимизации или максимизации.</li> <li>1 - Окно было свернуто (минимизировано).</li> <li>2 - Окно было развернуто (максимизировано).</li> </ul> </dd> </dl> </li> <li><p class="first">Ширина - новая ширина формы.</p> </li> <li><p class="first">Высота - новая высота формы.</p> </li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при изменении размеров окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриИзмененииРазмераОкна(Конт, ТипСобытия,Ширина,Высота) Если ТипСобытия = 1 Тогда Сообщить("Окно формы свернуто."); ИначеЕсли ТипСобытия = 2 Тогда Сообщить("Окно формы развернуто."); Иначе Сообщить("Новый размер формы: " + Ширина + "х" + Высота); КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id60" id="multilinepic" name="multilinepic">ПиктограммаМногострочнойЧасти / MultiLinePic</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПиктограммаМногострочнойЧасти(Контекст, НомерПиктограммы)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>НомерПиктограммы - номер пиктограммы в установленном наборе.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при вычислении номера системной пиктограммы в многострочной части формы списка. При вызове процедуры в параметр НомерПиктограммы передается значение, вычесленное системой. Если изменить значение этой переменной внутри процедуры, то для соответствующей строки многострочной части будет установлена пиктограмма в соответствии с этим новым значением. Внутри процедуры доступны реквизиты строки многострочной части (в частности ТекущийДокумент, ТекущийЭлемент() и т.д.). Выполнение процедуры замедляет вывод на экран и обновление формы списка, поэтому рекомендуется использовать в этой процедуре минимум вычислений. Эта процедура подразумевается, как дополнение метода <a class="reference" href="#settablepicture">УстановитьКартинкуМногострочнойЧасти / SetTablePicture</a> для установки собственных пиктограмм в многострочной части формы списка.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПиктограммаМногострочнойЧасти(Конт, НомерПиктограммы) Если Конт.Вид() = "Номенклатура" Тогда Если Конт.ЭтоГруппа() = 1 Тогда НомерПиктограммы = 1; Иначе НомерПиктограммы = 2; КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id61" id="id7" name="id7">ПриЗагрузкеФормы</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриЗагрузкеФормы(ИмяОбъекта)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>ИмяОбъекта - полный путь к объекту, для которого загружается форма</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при загрузке диалога формы. В качестве параметра в процедуру передается полный путь к загружаемому объекту внутри md ( список всех форм можно получить с помощью метода <a class="reference" href="#allformslist">СписокВсехФорм / AllFormsList</a> ). Если внутри процедуры изменить значение параметра ИмяОбъекта, то загрузится диалог в соответствии с этим новым путем. Если новый путь задан неверно, то будет загружен тот диалог, который предполагался изначально.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриЗагрузкеФормы(ИмяОбъекта) ШИ = глПользователь.ШаблонИнтерфейса; Если ИмяОбъекта = "Справочник.Клиенты.Форма" Тогда Если ПустоеЗначение(ШИ) = 1 Тогда ИмяОбъекта = "Обработка.Пусто.Форма"; ИначеЕсли ШИ = Перечисление.Интерфейсы.Менеджер Тогда ИмяОбъекта = "Обработка.КлиентыМенеджер.Форма"; ИначеЕсли ШИ = Перечисление.Интерфейсы.Директор Тогда ИмяОбъекта = "Обработка.КлиентыДиректор.Форма"; Иначе КонецЕсли; ИначеЕсли ИмяОбъекта = "Справочник.Договоры.Форма" Тогда Если ПустоеЗначение(ШИ) = 1 Тогда ИмяОбъекта = "Обработка.Пусто.Форма"; ИначеЕсли ШИ = Перечисление.Интерфейсы.Менеджер Тогда ИмяОбъекта = "Обработка.ДоговорыМенеджер.Форма"; Иначе КонецЕсли; КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id62" id="id8" name="id8">ПриЗагрузкеМодуляФормы</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриЗагрузкеМодуляФормы(ИмяОбъекта)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>ИмяОбъекта - полный путь к объекту, для которого загружается форма</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при загрузке модуля формы. В качестве параметра в процедуру передается полный путь к загружаемому объекту внутри md ( список всех форм можно получить с помощью метода <a class="reference" href="#allformslist">СписокВсехФорм / AllFormsList</a> ). Если внутри процедуры изменить значение параметра ИмяОбъекта, то загрузится модуль в соответствии с этим новым путем. Если новый путь задан неверно, то будет загружен тот модуль, который предполагался изначально.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриЗагрузкеМодуляФормы(ИмяОбъекта) ШИ = глПользователь.ШаблонИнтерфейса; Если ИмяОбъекта = "Справочник.Клиенты.Форма" Тогда Если ПустоеЗначение(ШИ) = 1 Тогда ИмяОбъекта = "Обработка.Пусто.Форма"; ИначеЕсли ШИ = Перечисление.Интерфейсы.Менеджер Тогда ИмяОбъекта = "Обработка.КлиентыМенеджер.Форма"; ИначеЕсли ШИ = Перечисление.Интерфейсы.Директор Тогда ИмяОбъекта = "Обработка.КлиентыДиректор.Форма"; Иначе КонецЕсли; ИначеЕсли ИмяОбъекта = "Справочник.Договоры.Форма" Тогда Если ПустоеЗначение(ШИ) = 1 Тогда ИмяОбъекта = "Обработка.Пусто.Форма"; ИначеЕсли ШИ = Перечисление.Интерфейсы.Менеджер Тогда ИмяОбъекта = "Обработка.ДоговорыМенеджер.Форма"; Иначе КонецЕсли; КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id63" id="onloadasexternalform" name="onloadasexternalform">ПриЗагрузкеВнешнегоОтчета / OnLoadAsExternalForm</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриЗагрузкеВнешнегоОтчета(ИмяФайлаОтчета)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>ИмяФайлаОтчета - полный путь к файлу отчета (вместе с собственно именем файла).</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при загрузке внешнего отчета. Если в процедуре установить статус возврата в ноль, то внешний отчет не будет загружен.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриЗагрузкеВнешнегоОтчета(ИмяФайлаОтчета) // разрешен запуск внешних отчетов только из определенной папки РазрешенныйПуть = КаталогИБ() + "\ВнешниеОтчеты\"; Если Врег(Лев(ИмяФайлаОтчета,СтрДлина(РазрешенныйПуть))) <> Врег(РазрешенныйПуть) Тогда Сообщить("Запуск внешних отчетов разрешен только из каталога """+РазрешенныйПуть+""""); СтатусВозврата(0); КонецЕсли; КонецПроцедуры </pre> </div> </div> <div class="section"> <h2><a class="toc-backref" href="#id64" id="id9" name="id9">Локальные</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id65" id="id10" name="id10">ПослеСозданияФормы / OnCreateForm</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеСозданияФормы()</p> <p><strong>Описание:</strong> Предопределенная процедура вызывается после физического создания окна формы в системе, когда окно формы создано, но еще не полностью проинициализоровано и не отображено на экране. В этой процедуре (и во всех процедурах, вызываемых после нее) можно вызывать методы, которые помечены как <em>"работает только после физического открытия окна формы"</em>.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПослеСозданияФормы() ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.ФиксироватьМногострочнуюЧасть(2); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id66" id="id11" name="id11">ПослеОбновленияФормы / OnRefresh</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеОбновленияФормы()</p> <p><strong>Описание:</strong> Предопределенная процедура вызывается при обновлении формы, после выполнения форму текстовых реквизитов формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПослеОбновленияФормы() Состояние("Обновление формы!"); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id67" id="id12" name="id12">ПослеОткрытия / OnActivate</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеОткрытия()</p> <p><strong>Описание:</strong> Предопределенная процедура вызывается после физического создания окна формы в системе, когда окно формы создано, полностью проинициализировано и отображено на экране.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПослеОткрытия() ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.ФиксироватьМногострочнуюЧасть(2); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id68" id="id13" name="id13">ПослеЗакрытия / OnClosed</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеЗакрытия()</p> <p><strong>Описание:</strong> Предопределенная процедура вызывается после физического разрушения окна формы. Предотвратить закрытие окна в этой процедуре невозможно.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПослеЗакрытия() глЗаписатьСтрокуЛога(Контекст); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id69" id="id14" name="id14">ПриДвиженииМыши / OnMouseMove</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриДвиженииМыши(Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается движения мыши поверх формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвиженииМыши(сост, х, у) Состояние(" х = " + х + " у = " + у + " сост = " + сост); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id70" id="id15" name="id15">ПриНажатииПравойКнопки / OnRButtonDown</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриНажатииПравойКнопки(Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при нажатии правой кнопки мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриНажатииПравойКнопки(сост, х, у) Сообщить("Нажата правая кнопка мыши."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id71" id="id16" name="id16">ПриОтжатииПравойКнопки / OnRButtonUp</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриОтжатииПравойКнопки(Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается когда отпущена правая кнопка мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриОтжатииПравойКнопки(сост, х, у) Сообщить("Отпущена правая кнопка мыши."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id72" id="id17" name="id17">ПриДвойномНажатииПравойКнопки / OnRButtonDblClk</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриДвойномНажатииПравойКнопки(Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при двойном клике правой кнопкой мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвойномНажатииПравойКнопки(сост, х, у) Предупреждение("Двойной правый клик по форме."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id73" id="id18" name="id18">ПриНажатииЛевойКнопки / OnLButtonDown</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриНажатииЛевойКнопки(Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при нажатии левой кнопки мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриНажатииЛевойКнопки(сост, х, у) Сообщить("Нажата левая кнопка мыши."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id74" id="id19" name="id19">ПриОтжатииЛевойКнопки / OnLButtonUp</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриОтжатииЛевойКнопки(Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается когда отпущена левая кнопка мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриОтжатииЛевойКнопки(сост, х, у) Сообщить("Отпущена левая кнопка мыши."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id75" id="id20" name="id20">ПриДвойномНажатииЛевойКнопки / OnLButtonDblClk</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриДвойномНажатииЛевойКнопки(Состояние, КоордПоГоризонтали, КоордПоВертикали, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Состояние - битовая маска, показывающаяя текущее состояние кнопок мыши.</li> <li>КоордПоГоризонтали - значение координаты курсора мыши по горизонтальной оси (Х).</li> <li>КоордПоВертикали - значение координаты курсора мыши по вертикальной оси (Y).</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при двойном клике левой кнопкой мыши.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвойномНажатииЛевойКнопки(сост, х, у) Предупреждение("Двойной левый клик по форме."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id76" id="id21" name="id21">ПриНажатииКнопкиКлавиатуры / OnChar</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриНажатииКнопкиКлавиатуры(КодКлавиши, Alt, Shift, Ctrl, Символ, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>КодКлавиши - код нажатой кнопки клавиатуры.</li> <li>Alt - флаг нажатия кнопки <Alt>.</li> <li>Shift - флаг нажатия кнопки <Shift>.</li> <li>Ctrl - флаг нажатия кнопки <Ctrl>.</li> <li>Символ - символ нажатой кнопки в формате ASCII.</li> <li>ФСО - флаг стандартной обработки. Изначально равен 1. Если в теле процедуры сбросить значение в 0, то стандартная обработка события не вызывается.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при нажатии кнопки клавиатуры.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриНажатииКнопкиКлавиатуры(код, _а, _ш, _к) Предупреждение("Нажата кнопка клавиатуры."); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id77" id="id22" name="id22">ПриИзмененииРазмераОкна / OnSize</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриИзмененииРазмераОкна(ТипСобытия, Ширина, Высота)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last"> <li><dl class="first docutils"> <dt>ТипСобытия - определяет тип запрошенного изменения размеров. Этот параметр может принимать одно из следующих значений:</dt> <dd><ul class="first last simple"> <li>0 - Окно было изменено, но без минимизации или максимизации.</li> <li>1 - Окно было свернуто (минимизировано).</li> <li>2 - Окно было развернуто (максимизировано).</li> </ul> </dd> </dl> </li> <li><p class="first">Ширина - новая ширина формы.</p> </li> <li><p class="first">Высота - новая высота формы.</p> </li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при изменении размеров окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриИзмененииРазмераОкна(ТипСобытия, Ширина, Высота) Если ТипСобытия = 1 Тогда Сообщить("Окно формы свернуто."); ИначеЕсли ТипСобытия = 2 Тогда Сообщить("Окно формы развернуто."); Иначе Сообщить("Новый размер формы: " + Ширина + "х" + Высота); КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id78" id="id23" name="id23">ПиктограммаМногострочнойЧасти / MultiLinePic</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПиктограммаМногострочнойЧасти(НомерПиктограммы)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Контекст - контекст формы</li> <li>НомерПиктограммы - номер пиктограммы в установленном наборе.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Предопределенная процедура вызывается при вычислении номера системной пиктограммы в многострочной части формы списка. При вызове процедуры в параметр НомерПиктограммы передается значение, вычесленное системой. Если изменить значение этой переменной внутри процедуры, то для соответствующей строки многострочной части будет установлена пиктограмма в соответствии с этим новым значением. Внутри процедуры доступны реквизиты строки многострочной части (в частности ТекущийДокумент, ТекущийЭлемент() и т.д.). Выполнение процедуры замедляет вывод на экран и обновление формы списка, поэтому рекомендуется использовать в этой процедуре минимум вычислений. Эта процедура подразумевается, как дополнение метода <a class="reference" href="#settablepicture">УстановитьКартинкуМногострочнойЧасти / SetTablePicture</a> для установки собственных пиктограмм в многострочной части формы списка.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПиктограммаМногострочнойЧасти(НомерПиктограммы) Если ЭтоГруппа() = 1 Тогда НомерПиктограммы = 1; Иначе НомерПиктограммы = 2; КонецЕсли; КонецПроцедуры </pre> </div> </div> <div class="section"> <h2><a class="toc-backref" href="#id79" id="id24" name="id24">Локальные (для обработки событий объекта "Дерево+Таблица")</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id80" id="onitemexpanding" name="onitemexpanding">ПриРазворачиванииУзла / OnItemExpanding</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриРазворачиванииУзла(НомерСтроки, ФСО)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>НомерСтроки - строка с полным путем ветви дерева, которая готовится к раскрытию;</li> <li>ФСО - флаг стандартной обработки. При установке его в 0 ветвь не будет раскрыта.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Процедура вызывается при начале разворачивания ветви дерева.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id81" id="onitemexpanded" name="onitemexpanded">ПослеРазворачиванияУзла / OnItemExpanded</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеРазворачиванияУзла(<НомерСтроки>)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>НомерСтроки - строка с полным путем ветви дерева, которая раскрылась.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Процедура вызывается после разворачивания ветви дерева, но до отображения этого действия на форме.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id82" id="onitemcollapsing" name="onitemcollapsing">ПриСворачиванииУзла / OnItemCollapsing</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриСворачиванииУзла(<НомерСтроки>,<ФСО>)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>НомерСтроки - строка с полным путем ветви дерева, которая готовится к сворачиванию;</li> <li>ФСО - флаг стандартной обработки. При установке его в 0 ветвь не будет свернута.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Процедура вызывается при начале сворачивания ветви дерева.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id83" id="onitemcollapsed" name="onitemcollapsed">ПослеСворачиванияУзла / OnItemCollapsed</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПослеСворачиванияУзла(НомерСтроки)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>НомерСтроки - строка с полным путем ветви дерева, которая свернулась.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Процедура вызывается после сворачивания ветви дерева, но до отображения этого действия на форме.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id84" id="onlbuttonovertree" name="onlbuttonovertree">ПриНажатииЛевойКнопкиНадДеревом / OnLButtonOverTree</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриНажатииЛевойКнопкиНадДеревом(НомерСтроки, НомерКолонки)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>НомерСтроки - строка с полным путем ветви дерева, над которой произошел клик;</li> <li>НомерКолонки - число - номер колонки, над которой произошел клик.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Процедура вызывается при одиночном клике левой кнопкой мыши над объектом. При двойном клике левой кнопкой мыши над объектом срабатывает функция, которая прописана в формуле перехватываемой таблицы значений.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id85" id="onrbuttonovertree" name="onrbuttonovertree">ПриНажатииПравойКнопкиНадДеревом / OnRButtonOverTree</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПриНажатииПравойКнопкиНадДеревом(НомерСтроки, НомерКолонки)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>НомерСтроки - строка с полным путем ветви дерева, над которой произошел клик;</li> <li>НомерКолонки - число - номер колонки, над которой произошел клик.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Процедура вызывается при одиночном клике правой кнопкой мыши над объектом.</p> </blockquote> </div> </div> </div> <div class="section"> <h1><a class="toc-backref" href="#id86" id="table" name="table">Объект Таблица / Table (доработка стандартного объекта)</a></h1> <div class="section"> <h2><a class="toc-backref" href="#id87" id="id25" name="id25">Методы</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id88" id="sourcetable" name="sourcetable">ИсходнаяТаблица / SourceTable</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ИсходнаяТаблица(Имя[, Путь])</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>Имя - строка, которая задает имя таблицы формы или имя файла содержащего таблицу;</li> <li>Путь - строка с путем к форме, внутри которой необходимо произвести поиск таблицы. Внутренние формы задаются в виде "MD.<ПолныйПутьВнутриMD>" (например, "MD.Документ.ПриходнаяНакладная.Форма"). Полный список внутренних форм можно получить вызвав метод <a class="reference" href="#allformslist">СписокВсехФорм / AllFormsList</a>. Строка вида "<ИмяОбработки>@MD" преобразуется к виду "MD.Обработка.<ИмяОбработки>.Форма". Если строка пути начинается не с "MD.", то она воспринимается как путь к файлу внешнего отчета и исходная таблица ищется в этом файле. Необязательный параметр. По умолчанию - пустая строка.</li> </ul> </dd> <dt><strong>Возвращает:</strong> число с результатом выполнения:</dt> <dd><ul class="first last simple"> <li>0 - при поиске исходной таблицы произошла ошибка,</li> <li>1 - исходная таблица нормально установлена,</li> <li>2 - произошел вызов штатной установки исходной таблицы с неизвестным результатом.</li> </ul> </dd> </dl> <p><strong>Описание:</strong> Переназначает в качестве исходной таблицы-шаблона одну из таблиц той формы, в программном модуле которой запущена данная процедура (или формы указаной в параметре Путь). Имя таблицы сначала ищется в форме модуля, потом в общих таблицах (если не форма не задана явно параметром Путь). Если такой таблицы нет и параметр Путь не задан, то переданное имя будет рассматриваться как имя файла, содержащего данную таблицу.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id89" id="options" name="options">Опции / Options</a></h3> <blockquote> <strong>Описание:</strong> Исправлена работа метода для таблиц на форме. В штатном варианте возможно фиксировать строки и колонки в таблице только до физического создания окна таблицы. Данная доработка позволяет менять фиксацию строк и колонок в уже выведенной таблице. Исправление происходит в автоматическом режиме и никаких дополнительных усилий со стороны программиста не требуется.</blockquote> </div> </div> </div> <div class="section"> <h1><a class="toc-backref" href="#id90" id="service" name="service">Объект Сервис / Service</a></h1> <div class="section"> <h2><a class="toc-backref" href="#id91" id="id26" name="id26">Методы</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id92" id="colourbrowse" name="colourbrowse">ВключитьРаскраскуТаблиц / ColourBrowse</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВключитьРаскраскуТаблиц([ВыборочнаяРаскраска])</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>ВыборочнаяРаскраска - тип: Число. Флаг, показывающий, что раскрашиваться будут только таблицы явно указанных контекстов : 1 - выборочная раскраска; 0 - полная раскраска. Необязательный. По умолчанию - 0. Этот флаг может быть изменен путем установки/сброса флажка на странице свойств компоненты (в главном меню: Сервис - Параметры).</li> </ul> </blockquote> <p><strong>Описание:</strong> Разрешает раскраску таблиц.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); Сервис.ВключитьРаскраскуТаблиц(); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id93" id="uncolourbrowse" name="uncolourbrowse">ВыключитьРаскраскуТаблиц / UnColourBrowse</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВыключитьРаскраскуТаблиц()</p> <p><strong>Описание:</strong> Запрещает раскраску таблиц.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект(""Сервис""); Сервис.ВыключитьРаскраскуТаблиц(); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id94" id="activecontext" name="activecontext">АктивныйКонтекст / ActiveContext</a></h3> <blockquote> <p><strong>Синтаксис:</strong> АктивныйКонтекст(Контекст)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Контекст - тип: Любой. Переменная, в которую возвращается активный контекст.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> результат выполнения метода в виде числа: 1 в случае успеха, 0 в противном случае.</p> <p><strong>Описание:</strong> Предназначен для получения контекст активного в данный момент окна. В качестве контекста окна с выведенной mxl-таблицей возвращается объект Таблица.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ЗакрытьАктивноеОкно() Перем Конт; Сервис = СоздатьОбъект("Сервис"); Если Сервис.АктивныйКонтекст(Конт) = 1 Тогда Если ТипЗначенияСтр(Конт) = "Таблица" Тогда Конт.Показать("","",-1); Иначе Конт.Форма.Закрыть(0); КонецЕсли; Иначе Сообщить("Активное окно не является контекстным или нет активного окна."); КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id95" id="callasprocedure" name="callasprocedure">ВыполнитьПроцедуру / CallAsProcedure</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВыполнитьПроцедуру(Контекст, ИмяПроцедуры, СписокАргументов)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Контекст - тип: ГрупповойКонтекст. Контекст, в котором необходимо выполнить процедуру. Необязательный. По умолчанию - текущий контекст.</li> <li>ИмяПроцедуры - тип: Строка. Имя процедуры.</li> <li>СписокАргументов - тип: СписокЗначений. Список значений, содержащий аргументы процедуры. Если размер списка меньше, чем количество аргументов процедуры, то в оставшиеся аргументы передаются пустые значения. Лишние значения игнорируются. Значения по умолчанию игнорируются. Необязательный. По умолчанию - пустой список.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> результат выполнения метода в виде числа: 1 в случае успеха, 0 в противном случае.</p> <p><strong>Описание:</strong> Метод предназначен для выполнения процедуры в заданном контексте.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Перем Конт; Сервис = СоздатьОбъект("Сервис"); Если ОткрытьФорму("Обработка.Демо", Конт) = 1 Тогда Список = СоздатьОбъект("СписокЗначений"); Список.ДобавитьЗначение("Первый параметр"); Список.ДобавитьЗначение("Второй параметр"); Список.ДобавитьЗначение("Третий параметр"); Сервис.ВыполнитьПроцедуру(Конт, "Выполнить", Список); КонецЕсли; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id96" id="callasfunction" name="callasfunction">ВыполнитьФункцию / CallAsFunction</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВыполнитьФункцию(Контекст, ИмяФункции, СписокАргументов, Результат)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Контекст - тип: ГрупповойКонтекст. Контекст, в котором необходимо выполнить функцию. Необязательный. По умолчанию - текущий контекст.</li> <li>ИмяФункции - тип: Строка. Имя функции.</li> <li>СписокАргументов - тип: СписокЗначений. Список значений, содержащий аргументы функции. Если размер списка меньше, чем количество аргументов функции, то в оставшиеся аргументы передаются пустые значения. Лишние значения игнорируются. Значения по умолчанию игнорируются. Необязательный. По умолчанию - пустой список.</li> <li>Результат - тип: Любой. Переменная, в которую записывается результат выполнения функции.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> результат выполнения метода в виде числа: 1 в случае успеха, 0 в противном случае.</p> <p><strong>Описание:</strong> Метод предназначен для выполнения функции в заданном контексте.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Перем Конт, Рез; Сервис = СоздатьОбъект("Сервис"); Если ОткрытьФорму("Обработка.Демо", Конт) = 1 Тогда Список = СоздатьОбъект("СписокЗначений"); Список.ДобавитьЗначение("Первый параметр"); Список.ДобавитьЗначение("Второй параметр"); Список.ДобавитьЗначение("Третий параметр"); Сервис.ВыполнитьФункцию(Конт, "Выполнить", Список, Рез); КонецЕсли; Сообщить("Результат выполнения функции: " + Рез); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id97" id="getcontextvar" name="getcontextvar">ПолучитьПеременнуюКонтекста / GetContextVar</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьПеременнуюКонтекста(Контекст, ИмяПеременной, Результат)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Контекст - тип: ГрупповойКонтекст. Контекст, в котором необходимо вычислить значение переменной. Необязательный. По умолчанию - текущий контекст.</li> <li>ИмяПеременной - тип: Строка. Имя переменной.</li> <li>Результат - тип: Любой. Переменная, в которую записывается значение переменной контекста.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> результат выполнения метода в виде числа: 1 в случае успеха, 0 в противном случае.</p> <p><strong>Описание:</strong> Метод предназначен для вычисления значения переменной в заданном контексте.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Перем Конт, Рез; Сервис = СоздатьОбъект("Сервис"); ОткрытьФорму("Обработка.Демо", Конт); Если Сервис.ПолучитьПеременнуюКонтекста(Конт,"НекаяПеременная",Рез) = 1 Тогда Сообщить("Значение переменной контекста: " + Рез); КонецЕсли; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id98" id="setcontextvar" name="setcontextvar">УстановитьПеременнуюКонтекста / SetContextVar</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьПеременнуюКонтекста(Контекст, ИмяПеременной, НовоеЗначение)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Контекст - тип: ГрупповойКонтекст. Контекст, в котором необходимо установить значение переменной. Необязательный. По умолчанию - текущий контекст.</li> <li>ИмяПеременной - тип: Строка. Имя переменной.</li> <li>НовоеЗначение - тип: Любой. Значение, в которое необходимо установить переменную.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> результат выполнения метода в виде числа: 1 в случае успеха, 0 в противном случае.</p> <p><strong>Описание:</strong> Метод предназначен для установки значения переменной в заданном контексте.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Перем Конт, Рез; Сервис = СоздатьОбъект("Сервис"); ОткрытьФорму("Обработка.Демо", Конт); Если Сервис.ПолучитьПеременнуюКонтекста(Конт,"НекаяПеременная",Рез) = 1 Тогда Сообщить("Старое значение переменной контекста: " + Рез); КонецЕсли; Если Сервис.УстановитьПеременнуюКонтекста(Конт,"НекаяПеременная","Новое значение") = 1 Тогда Если Сервис.ПолучитьПеременнуюКонтекста(Конт,"НекаяПеременная",Рез) = 1 Тогда Сообщить("Новое значение переменной контекста: " + Рез); КонецЕсли; КонецЕсли; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id99" id="choosevalue" name="choosevalue">ВыбратьЗначение / ChooseValue</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВыбратьЗначение(СписокЗначений, Значение, Заголовок, СпособВыбора, Флаг, Шрифт)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">СписокЗначений - тип: СписокЗначений. Список значений, из которого необходимо произвести выбор;</p> </li> <li><p class="first">Значение - тип: Любой. Переменная, куда помещается результат выбора;</p> </li> <li><p class="first">Заголовок - тип: Строка. Заголовок диалогового окна выбора;</p> </li> <li><dl class="first docutils"> <dt>СпособВыбора - тип: Число. Необязательный. Значение по умолчанию - 0. Способ выбора значения:</dt> <dd><ul class="first last simple"> <li>0 - выбор в виде многоуровневого меню;</li> <li>1 - выбор в виде дерева.</li> </ul> </dd> </dl> </li> <li><dl class="first docutils"> <dt>Флаг - тип: Число. Необязательный. Значение по умолчанию - 0.</dt> <dd><ul class="first last simple"> <li>Для выбора в дереве: 1 - разрешить выбор групп; 0 - запретить.</li> <li>Для выбора в меню: 0 - простой выбор; 1 - пометка значений; 2 - простой выбор (без привязки к активному реквизиту); 3 - пометка значений (без привязки к активному реквизиту). Если указано значение из разряда без привязки к активному реквизиту, то меню показывается в текущей позиции курсора мыши.</li> </ul> </dd> </dl> </li> <li><p class="first">Шрифт - тип: Число. Код пользовательского шрифта, возвращенный методом <a class="reference" href="#createfont">СоздатьШрифт / CreateFont</a> для вывода меню. Необязательный. По умолчанию - системный шрифт.</p> </li> </ul> </blockquote> <p><strong>Возвращает:</strong> результат выполнения метода в виде числа: 1 в случае успеха (выбор произведен), 0 в противном случае.</p> <p><strong>Описание:</strong> Метод предназначен для интерактивного выбора значения из многоуровневого списка. Многоуровневость обеспечивается вложенностью списков значений (см. Пример). Количество уровней не ограничено. Если выбор производится в меню, то значения с представлением "-" воспринимаются как разделители.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); Список = СоздатьОбъект("СписокЗначений"); Список.ДобавитьЗначение(1,"Пункт 1"); Список.ДобавитьЗначение(2,"Пункт 2"); Список.ДобавитьЗначение(3,"Пункт 3"); Список.ДобавитьЗначение(4,"Пункт 4"); Список.ДобавитьЗначение(0,"-"); // создаем вложенный список СписокДоп = СоздатьОбъект("СписокЗначений"); СписокДоп.ДобавитьЗначение(551,"Пункт 51"); СписокДоп.ДобавитьЗначение(552,"Пункт 52"); СписокДоп.ДобавитьЗначение(553,"Пункт 53"); СписокДоп.ДобавитьЗначение(554,"Пункт 54"); // добавляем вложенный список Список.ДобавитьЗначение(СписокДоп,"Пункт 5"); Список.ДобавитьЗначение(6,"Пункт 6"); Список.ДобавитьЗначение(7,"Пункт 7"); Выб = ""; Если Сервис.ВыбратьЗначение(Список,Выб,"Тестовый выбор значения",0) = 1 Тогда Сообщить(Выб); КонецЕсли; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id100" id="addglobalmodule" name="addglobalmodule">ДобавитьГлобальныйМодуль / AddGlobalModule</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ДобавитьГлобальныйМодуль(<ТекстМодуля>)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>ТекстМодуля - тип: Строка. Текст добавляемого глобального модуля.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> В случае удачной загрузки возвращает номер загруженного глобального модуля, иначе - 0.</p> <p><strong>Описание:</strong> Загружает, компилирует и запускает дополнительный глобальный модуль.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); глДопМодуль = Сервис.ДобавитьГлобальныйМодуль("#ЗагрузитьИзФайла ГлобМодуль1.txt"); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id101" id="deleteglobalmodule" name="deleteglobalmodule">УдалитьГлобальныйМодуль / DeleteGlobalModule</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УдалитьГлобальныйМодуль(НомерМодуля)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>НомерМодуля - тип: Число. Номер дополнительного глобального модуля.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> результат выполнения метода в виде числа: 1 в случае успеха , 0 в противном случае.</p> <p><strong>Описание:</strong> Выгружает дополнительный глобальный модуль по его номеру.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Если глДопМодуль > 0 Тогда Сервис = СоздатьОбъект("Сервис"); Сервис.УдалитьГлобальныйМодуль(глДопМодуль); КонецЕсли; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id102" id="showkeyboardindicator" name="showkeyboardindicator">ПоказыватьИндикаторКлавиатуры / ShowKeyboardIndicator</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПоказыватьИндикаторКлавиатуры(Флаг)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Флаг - тип: Число. 0 - отключить показ; 1 - включить показ. Значение этого флага может быть изменено путем установки/сброса флажка на странице свойств компоненты (в главном меню: Сервис - Параметры).</li> </ul> </blockquote> <p><strong>Описание:</strong> Включает/отключиет показ ракладки клавиатуры и времени в статусной панели 1С:Предприятия.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); Сервис.ПоказыватьИндикаторКлавиатуры(1); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id103" id="setwallpaper" name="setwallpaper">УстановитьОбои / SetWallpaper</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьОбои(Имя, Положение, Серый, ЦветФона)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">Имя - тип: Строка. Имя файла с картинкой (bmp) или идентификатор картинки в библиотеки картинок. Может быть пустой строкой. В этом случае следующие параметры применяются к текущей загруженной картинке.</p> </li> <li><dl class="first docutils"> <dt>Положение - тип: Число. Задает положение картинки в окне. Может принимать следующие значения:</dt> <dd><ul class="first last simple"> <li>0 - не показывать картинку;</li> <li>1 - показывать в левом верхнем углу;</li> <li>2 - показывать в правом верхнем углу;</li> <li>3 - показывать в левом нижнем углу;</li> <li>4 - показывать в правом нижнем углу;</li> <li>5 - показывать по центру экрана;</li> <li>6 - растянуть картинку во все окно;</li> <li>7 - размножить картинку по окну.</li> </ul> </dd> </dl> </li> <li><p class="first">Серый - тип: Число. Флаг, задающий показ картинки в режиме градаций серого: 0 - показ в оригинальном виде; 1 - показ в обесцвеченном виде. Необязательный. По умолчанию 0.</p> </li> <li><p class="first">ЦветФона - тип: Число. Число в RGB, задает цвет фона всего окна заднего плана. Необязательный. По умолчанию - системное значение.</p> </li> </ul> </blockquote> <p><strong>Описание:</strong> Метод позволяет загрузить свою картику на задний план главного окна 1С:Предприятия. Если в библиотеке картинок есть картинка с идентификатором Wallpaper, то при загрузке компоненты она автоматически загружается в качестве обоев в левый верхний угол, в режиме оригинального отображения.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); Сервис.УстановитьОбои("Лого",4,1,255); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id104" id="heighttablestring" name="heighttablestring">ВысотаСтрокиТаблицы / HeightTableString</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВысотаСтрокиТаблицы(Таблица, НомерСтроки, ТипВозврата)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">Таблица - тип: Таблица. Объект штатного типа, для которого необходимо определить высоту строки.</p> </li> <li><p class="first">НомерСтроки - тип: Число. Номер строки, высоту которой необходимо вычислить.</p> </li> <li><dl class="first docutils"> <dt>ТипВозврата - тип: Число. Флаг, задающий тип возвращаемого значения. Может принимать следующие значения:</dt> <dd><ul class="first last simple"> <li>1 - возвращается значение в миллиметрах,</li> <li>2 - возвращается значение в экранных пикселах,</li> <li>3 - возвращается значение во внутренних юнитах 1С.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Возвращает:</strong> Число, интерпритация которого зависит от параметра ТипВозврата.</p> <p><strong>Описание:</strong> Возвращает высоту строки объекта Таблица в заданных единицах. Метод работает только для таблиц, которые уже выведены на экран методом Показать().</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); Таб.Показать("Тест"); Сервис.ПрятатьТаблицу(Таб,1); Для инд = 1 по Таб.ВысотаТаблицы() Цикл Сообщить(""+инд+" : " +Сервис.ВысотаСтрокиТаблицы(Таб, инд, 1)+"мм. : " +Сервис.ВысотаСтрокиТаблицы(Таб, инд, 2)+" : " +Сервис.ВысотаСтрокиТаблицы(Таб, инд, 3)); КонецЦикла; Сервис.ПрятатьТаблицу(Таб,0); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id105" id="hidetable" name="hidetable">ПрятатьТаблицу / HideTable</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПрятатьТаблицу(Таблица, Флаг)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Таблица - тип: Таблица. Объект штатного типа, окно которого необходимо спрятать или показать.</li> <li>Флаг - тип: Число. Флаг отображения таблицы: 1 - скрывает окно таблицы, 0 - показывает скрытое ранее окно.</li> </ul> </blockquote> <p><strong>Описание:</strong> Прячет/показывает выведенное окно таблицы. Окно таблицы делаеться невидимым, но не уничтожается. Программисту необходимо следить самостоятельно, чтобы скрытые окна после обработки вновь делались видимыми.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); Таб.Показать("Тест"); Сервис.ПрятатьТаблицу(Таб,1); Для инд = 1 по Таб.ВысотаТаблицы() Цикл Сообщить(""+инд+" : " +Сервис.ВысотаСтрокиТаблицы(Таб, инд, 1)+"мм. : " +Сервис.ВысотаСтрокиТаблицы(Таб, инд, 2)+" : " +Сервис.ВысотаСтрокиТаблицы(Таб, инд, 3)); КонецЦикла; Сервис.ПрятатьТаблицу(Таб,0); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id106" id="idleprocessing" name="idleprocessing">ОбработкаОжидания / IdleProcessing</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ОбработкаОжидания(Имя, Интервал)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Имя - тип: Строка. Имя глобальной процедуры для периодического вызова (если в качестве параметра передается пустая строка, то ранее запущенный процесс прекращается);</li> <li>Интервал - тип: Число. Интервал вызова процедуры в миллисекундах (если в качестве параметра передается 0 (ноль), то ранее запущенный процесс прекращается).</li> </ul> </blockquote> <p><strong>Описание:</strong> Вызывает глобальную процедуру с заданным интервалом в милисекундах. В отличии от штатной обработки ожидания, вызывается при открытых модальных формах.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); Сервис.ОбработкаОжидания("глПолучитьНовыеЗаявки",200); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id107" id="commandline" name="commandline">КоманднаяСтрока / CommandLine</a></h3> <blockquote> <p><strong>Синтаксис:</strong> КоманднаяСтрока()</p> <p><strong>Возвращает:</strong> коммандную строку, с который было запущено 1С:Предприятие.</p> <p><strong>Описание:</strong> Метод предназначен для доступа к командной строке запуска программы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); Сообщить(Сервис.КоманднаяСтрока()); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id108" id="gettablenames" name="gettablenames">ПолучитьИменаТаблицы / GetTableNames</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьИменаТаблицы(Таблица)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Таблица - тип: Таблица. Объект штатного типа, для которого необходимо получить список поименованных областей.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> таблицу значений с адресами и идентификаторами поименованных областей (колонки ТЗ: "Адрес", "Идентификатор", "Лево", "Верх", "Право", "Низ").</p> <p><strong>Описание:</strong> Метод предназначен для получения списка поименованных областей таблицы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id109" id="osversion" name="osversion">ВерсияОС / OSVersion</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВерсияОС()</p> <p><strong>Возвращает:</strong> строку с описанием версии операционной системы.</p> <p><strong>Описание:</strong> Метод предназначен для определения версии операционной системы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект(""Сервис""); Сообщить(Сервис.ВерсияОС()); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id110" id="getprinterslist" name="getprinterslist">ПолучитьСписокПринтеров / GetPrintersList</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьСписокПринтеров()</p> <p><strong>Возвращает:</strong> список значений, где значения - имена принтеров.</p> <p><strong>Описание:</strong> метод предназначен для получения списка установленных в системе принтеров.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id111" id="isprinterready" name="isprinterready">ГотовностьПринтера / IsPrinterReady</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ГотовностьПринтера(ИмяПринтера)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>ИмяПринтера - тип: Строка. Имя принтера в ОС.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> показатель готовности принтера - число или список значений с ошибками. Числовое значение может быть: 0 - принтер готов к печати; -2 - невозможно создать список значений для возврата списка ошибок.</p> <p><strong>Описание:</strong> Метод предназначен для определения готовности принтера к печати.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id112" id="play" name="play">Воспроизвести / Play</a></h3> <blockquote> <p><strong>Синтаксис:</strong> Воспроизвести(ИмяФайла)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>ИмяФайла - тип: Строка. Полное имя wav-файла, который тербуется проиграть.</li> </ul> </blockquote> <p><strong>Описание:</strong> Проигрывает wav-файл, переданный в качестве параметра.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id113" id="listmoxel" name="listmoxel">СписокТаблиц / ListMoxel</a></h3> <blockquote> <p><strong>Синтаксис:</strong> СписокТаблиц()</p> <p><strong>Возвращает:</strong> список значений, значения в котором имеют тип Таблица.</p> <p><strong>Описание:</strong> Метод предназначен для получения списка объектов Таблица, у которых в данный момент открыты окна вывода (например, методом Показать()).</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id114" id="setcurcor" name="setcurcor">УстановитьКурсор / SetCurcor</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьКурсор(ИмяКурсора)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><dl class="first docutils"> <dt>ИмяКурсора - тип: Число/Строка. Если в качестве параметра передается строковое значение, то оно воспринимается как путь к файлу с курсором. Если ни чего не передавать, то для окна восстанавливается курсор по умолчанию. Если передается числовое значение, то устанавливается системный курсор. Возможные числовые значения (любое другое числовое значение восстанавливает курсор по умолчанию):</dt> <dd><ul class="first last simple"> <li>(значение) - (константа WIndows, которой соответсвует это значение)</li> <li>1 - IDC_ARROW;</li> <li>2 - IDC_IBEAM;</li> <li>3 - IDC_WAIT;</li> <li>4 - IDC_CROSS;</li> <li>5 - IDC_UPARROW;</li> <li>6 - IDC_SIZENWSE;</li> <li>7 - IDC_SIZENESW;</li> <li>8 - IDC_SIZEWE;</li> <li>9 - IDC_SIZENS;</li> <li>10 - IDC_SIZEALL;</li> <li>11 - IDC_NO;</li> <li>12 - IDC_APPSTARTING;</li> <li>13 - IDC_HELP.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для установки пользовательского курсора главному окну программы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвиженииМыши(сост, х, у) Сервис = СоздатьОбъект("Сервис"); ФормаРасш = СоздатьОбъект("РасширениеФормы"); Атр = ФормаРасш.ПолучитьАтрибутПоКоординатам(х,у); Если ТипЗначенияСтр(Атр) = "АтрибутФормы" Тогда Сервис.УстановитьКурсор(Число(Атр.Заголовок)); Иначе Сервис.УстановитьКурсор(0); КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id115" id="sendkeys" name="sendkeys">ЭмулироватьКлавиатуру / SendKeys</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ЭмулироватьКлавиатуру(Строка, Ждать, Раскладка)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">Строка - тип: Строка. Строка для отсылки в буфер клавиатуры (подробнее см. документацию по методу SendKeys из WSH);</p> </li> <li><p class="first">Ждать - тип: Число. Флаг ожидания обработки сообщения: 1 - продолжать программу только после обработки сообщения клавиатуры Windows; 0 - продолжить выполнение, не дожидаясь обработки сообщения. Необязательный. По умолчанию - 0.</p> </li> <li><dl class="first docutils"> <dt>Раскладка - тип: Число/Строка. Необязательный. По умолчанию "English (United States)". Строка с наименованием раскладки или число, соответствующее следующим раскладкам:</dt> <dd><ul class="first last simple"> <li>1 - "English (United States)";</li> <li>2 - "Russian";</li> <li>3 - "Ukrainian";</li> <li>4 - "Belarusian";</li> <li>5 - "German (Germany)";</li> <li>6 - "French (France)".</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для программной эмуляции нажатий кнопок клавиатуры.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура МаксимизироватьОкно() Сервис = СоздатьОбъект("Сервис"); Сервис.SendKeys("%"); Сервис.SendKeys("{LEFT}{DOWN}{DOWN}{DOWN}{DOWN}{DOWN}{ENTER}"); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id116" id="createfont" name="createfont">СоздатьШрифт / CreateFont</a></h3> <blockquote> <p><strong>Синтаксис:</strong> СоздатьШрифт(Имя, Высота, Жирность, Курсив, Подчеркивание, Зачеркивание, Наклон)</p> <dl class="docutils"> <dt><strong>Параметры:</strong> Все параметры являются необязательными. По умолчанию используются настройки шрифта - основания.</dt> <dd><ul class="first last"> <li><p class="first">Имя - тип: Строка. Системное имя шрифта;</p> </li> <li><p class="first">Высота - тип: Число. Высота создаваемого шрифта;</p> </li> <li><dl class="first docutils"> <dt>Жирность - тип: Число. Жирность создаваемого шрифта. Может принимать следующие значения:</dt> <dd><ul class="first last simple"> <li>1 - THIN;</li> <li>2 - EXTRALIGHT;</li> <li>3 - LIGHT;</li> <li>4 - NORMAL;</li> <li>5 - MEDIUM;</li> <li>6 - SEMIBOLD;</li> <li>7 - BOLD;</li> <li>8 - EXTRABOLD;</li> <li>9 - HEAVY;</li> <li>другое - DONTCARE;</li> </ul> </dd> </dl> </li> <li><p class="first">Курсив - тип: Число. Флаг использования курсива;</p> </li> <li><p class="first">Подчеркивание - тип: Число. Флаг использования подчеркивания;</p> </li> <li><p class="first">Зачеркивание - тип: Число. Флаг использования зачеркивания;</p> </li> <li><p class="first">Наклон - тип: Число. Значение наклона создаваемого шрифта в десятых долях градуса (только положительное значение).</p> </li> </ul> </dd> </dl> <p><strong>Возвращает:</strong> число - код созданного шрифта.</p> <p><strong>Описание:</strong> Создает шрифт по указанным параметрам. За основу берется шрифт, установленный в профиле пользователя (настройка интерфейса). После окончания работы со шрифтом, его необходимо уничтожить.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id117" id="createfontcausedby" name="createfontcausedby">СоздатьШрифтНаОсновании / CreateFontCausedBy</a></h3> <blockquote> <p><strong>Синтаксис:</strong> СоздатьШрифт(Имя, Высота, Жирность, Курсив, Подчеркивание, Зачеркивание, Наклон)</p> <dl class="docutils"> <dt><strong>Параметры:</strong> Все параметры являются необязательными. По умолчанию используются настройки шрифта - основания.</dt> <dd><ul class="first last"> <li><p class="first">Основание - тип: Число. Код шрифта-основания;</p> </li> <li><p class="first">Имя - тип: Строка. Системное имя шрифта;</p> </li> <li><p class="first">Высота - тип: Число. Высота создаваемого шрифта;</p> </li> <li><dl class="first docutils"> <dt>Жирность - тип: Число. Жирность создаваемого шрифта. Может принимать следующие значения:</dt> <dd><ul class="first last simple"> <li>1 - THIN;</li> <li>2 - EXTRALIGHT;</li> <li>3 - LIGHT;</li> <li>4 - NORMAL;</li> <li>5 - MEDIUM;</li> <li>6 - SEMIBOLD;</li> <li>7 - BOLD;</li> <li>8 - EXTRABOLD;</li> <li>9 - HEAVY;</li> <li>другое - DONTCARE;</li> </ul> </dd> </dl> </li> <li><p class="first">Курсив - тип: Число. Флаг использования курсива;</p> </li> <li><p class="first">Подчеркивание - тип: Число. Флаг использования подчеркивания;</p> </li> <li><p class="first">Зачеркивание - тип: Число. Флаг использования зачеркивания;</p> </li> <li><p class="first">Наклон - тип: Число. Значение наклона создаваемого шрифта в десятых долях градуса (только положительное значение).</p> </li> </ul> </dd> </dl> <p><strong>Возвращает:</strong> число - код созданного шрифта.</p> <p><strong>Описание:</strong> Создает шрифт по указанным параметрам на основе указанного первым параметром шрифта. После окончания работы со шрифтом, его необходимо уничтожить.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id118" id="deletefont" name="deletefont">УдалитьШрифт / DeleteFont</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УдалитьШрифт(КодШрифта)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>КодШрифта - тип: Число. Код шрифта.</li> </ul> </blockquote> <p><strong>Описание:</strong> Уничтожает созданный пользователем шрифт.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id119" id="guid-getguid" name="guid-getguid">ПолучитьGUID / GetGUID</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьGUID()</p> <p><strong>Возвращает:</strong> строку со сгенерированным GUID.</p> <p><strong>Описание:</strong> Метод предназначен для генерирование GUID - глобальных уникальных идентификаторов.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект(""Сервис""); Сообщить(Сервис.ПолучитьGUID()); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id120" id="formex-versionformex" name="formex-versionformex">ВерсияFormEx / VersionFormEx</a></h3> <blockquote> <p><strong>Синтаксис:</strong> Версия(ВерсияСтрокой)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>ВерсияСтрокой - тип: Любой. Необязательная переменная, в которую возвращается номер версии в виде форматированной строки.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> текущую версию компоненты в виде числа. Номер версии представляется в виде шестнадцатиричного числа, каждое слово которого - разряд номера версии.</p> <p><strong>Описание:</strong> Метод предназначен для получения текущей версии ядра FormEx.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Сервис = СоздатьОбъект("Сервис"); стрВерсия = ""; Сообщить(Сервис.Версия(стрВерсия)); // выведет: "33554688" (0x02000100) Сообщить(стрВерсия); // выведет: "2.0.1.0" </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id121" id="asyncevent" name="asyncevent">ВнешнееСобытие / AsyncEvent</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВнешнееСобытие(Источник, Событие, Данные)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Источник - тип: Строка. Строка для передачи в процедуру ОбработкаВнешнегоСобытия();</li> <li>Событие - тип: Строка. Строка для передачи в процедуру ОбработкаВнешнегоСобытия();</li> <li>Данные - тип: Строка. Строка для передачи в процедуру ОбработкаВнешнегоСобытия().</li> </ul> </blockquote> <p><strong>Возвращает:</strong></p> <p><strong>Описание:</strong> Вызов внешнего события компоненты. Событие обрабатывается в предопределенной процедуре ОбработкаВнешнегоСобытия() текущей активной формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id122" id="mousehook" name="mousehook">ПерехватМыши / MouseHook</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПерехватМыши(НовоеЗначение)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>НовоеЗначение - тип: Число(1 или 0). Флаг разрешения перехвата событий мыши: 1 - разрешить перехват; 0 - запретить перехват. Необязательный. По умолчанию значение разрешения перехвата событий не изменяется.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> Флаг разрешения перехвата на момент до выполнения метода.</p> <p><strong>Описание:</strong> Метод разрешает или запрещает перехват и обработку событий мыши (см. <a class="reference" href="#id4">Предопределенные процедуры</a>).</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id123" id="keyhook" name="keyhook">ПерехватКлавиатуры / KeyHook</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПерехватКлавиатуры(НовоеЗначение)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>НовоеЗначение - тип: Число(1 или 0). Флаг разрешения перехвата событий клавиатуры: 1 - разрешить перехват; 0 - запретить перехват. Необязательный. По умолчанию значение разрешения перехвата событий не изменяется.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> Флаг разрешения перехвата на момент до выполнения метода.</p> <p><strong>Описание:</strong> Метод разрешает или запрещает перехват и обработку событий клавиатуры (см. <a class="reference" href="#id4">Предопределенные процедуры</a>).</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id124" id="valuelistdraw" name="valuelistdraw">ПерехватОтрисовкиСписков / ValueListDraw</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПерехватОтрисовкиСписков(НовоеЗначение)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>НовоеЗначение - тип: Число(1 или 0). Флаг разрешения перехвата отрисовки списков значений на формах: 1 - разрешить перехват; 0 - запретить перехват. Необязательный. По умолчанию значение разрешения перехвата отрисовки не изменяется.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> Флаг разрешения перехвата на момент до выполнения метода.</p> <p><strong>Описание:</strong> Метод разрешает или запрещает перехват отрисовки списков значения для включения или выключения раскраски списков значений (см. <a class="reference" href="#id3">Раскраска списков значений</a>).</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id125" id="allformslist" name="allformslist">СписокВсехФорм / AllFormsList</a></h3> <blockquote> <p><strong>Синтаксис:</strong> СписокВсехФорм()</p> <p><strong>Возвращает:</strong> штатный объект Текст, в котором строки содержат полные пути ко всем формам внутри текущего md.</p> <p><strong>Описание:</strong> Метод позволяет получить список всех форм конфигурации.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id126" id="opentoolsform" name="opentoolsform">ОткрытьПлавающуюФорму / OpenToolsForm</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ОткрытьПлавающуюФорму()</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>параметры метода аналогичны параметрам штатного метода ОткрытьФорму().</li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Число. 1 - при успешном выполнении метода, 0 - иначе.</p> <p><strong>Описание:</strong> Метод позволяет открыть форму в виде "плавающего" окна. Форма подобна модальной форме, но при ее открытии работа в главном окне не блокируется.</p> </blockquote> </div> </div> </div> <div class="section"> <h1><a class="toc-backref" href="#id127" id="id27" name="id27">Объект РасширениеФормы / FormEx</a></h1> <div class="section"> <h2><a class="toc-backref" href="#id128" id="id28" name="id28">Свойства</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id129" id="attribute" name="attribute"><АтрибутФормы> / <Attribute></a></h3> <blockquote> <p><strong>Доступ:</strong> только чтение.</p> <p><strong>Тип:</strong> <a class="reference" href="#attribex">Объект АтрибутФормы / AttribEx</a>.</p> <p><strong>Описание:</strong> Доступ к объекту АтрибутФормы, где <АтрибутФормы> - идентификатор элемента диалога, как он задан в конфигураторе.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); Сообщить(ФормаРасш.кнОК.Заголовок); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id130" id="top" name="top">Верх / Top</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Возвращает/устанавливает координату верхнего края формы относительно главного окна программы (для немодальных окон).</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id131" id="left" name="left">Лево / Left</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Возвращает/устанавливает координату верхнего края формы относительно главного окна программы (для немодальных окон).</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id132" id="height" name="height">Высота / Height</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Доступ к значению высоты формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.Высота = 250; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id133" id="width" name="width">Ширина / Width</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Доступ к значению ширины формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.Ширина = 250; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id134" id="maximize" name="maximize">Максимизирована / Maximize</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Возвращает/устанавливает признак развернутости окна формы (для немодальных окон). Работает только после физического открытия окна. В момент первого обновления формы (до вывода окна на экран) все формы в 1С имеют значение этого атрибута равным 0.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id135" id="minimize" name="minimize">Минимизирована / Minimize</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Возвращает/устанавливает признак свернутости окна формы (для немодальных окон). Работает только после физического открытия окна.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id136" id="label" name="label">Метка / Label</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Возвращает/устанавливет метку формы, которая задается при вызове метода ОткрытьФорму() после знака '#' в названии объекта.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id137" id="bkcolor" name="bkcolor">ЦветФона / BkColor</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Возвращает/устанавливает цвет фона формы. Если задано -1, то устанавливается цвет по умолчанию.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id138" id="description" name="description">Описание / Description</a></h3> <blockquote> <p><strong>Доступ:</strong> только чтение.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Возвращает описание формы, заданное в конфигураторе.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id139" id="moduletext" name="moduletext">ТекстМодуля / ModuleText</a></h3> <blockquote> <p><strong>Доступ:</strong> только чтение.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Возвращает текст модуля формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id140" id="transparency" name="transparency">Прозрачность / Transparency</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число (0..255).</p> <p><strong>Описание:</strong> Устанавливает коэффициент прозрачности для модальных форм (если она поддерживается операционной системой). Корректное чтения возможно только на системах WinXP и старше. 0 - полностью прозрачное окно; 255 - полностью непрозрачное окно.</p> </blockquote> </div> </div> <div class="section"> <h2><a class="toc-backref" href="#id141" id="id29" name="id29">Методы</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id142" id="assignform" name="assignform">УстановитьФорму / AssignForm</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьФорму(Форма)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Форма - тип: Форма. Штатный объект Форма, который можно получить через служебное свойство "Форма" контекста формы.</li> </ul> </blockquote> <p><strong>Описание:</strong> Привязавает указанную форму к объекту. Вся дальнейшая работа будет вестись именно с этой формой. При создании объекта РасширениеФормы, он сразу привязывается к форме текущего контекста, если таковая присутствует, т.е. объект создается не в процедуре глобального модуля.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.УстановитьФорму(Форма); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id143" id="getform" name="getform">ПолучитьФорму / GetForm</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьФорму()</p> <p><strong>Возвращает:</strong> штатный объект Форма.</p> <p><strong>Описание:</strong> Возвращает форму, к которой привязан текущий объект.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Фрм = ФормаРасш.ПолучитьФорму(); Фрм.Заголовок(Новый заголовок формы); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id144" id="getnumattrib" name="getnumattrib">КоличествоАтрибутов / GetNumAttrib</a></h3> <blockquote> <p><strong>Синтаксис:</strong> КоличествоАтрибутов()</p> <p><strong>Возвращает:</strong> тип: Число. Количество атрибутов формы.</p> <p><strong>Описание:</strong> Метод предназначен для получения количества атрибутов формы, к которой привязан текущий объект.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.УстановитьФорму(Форма); СписокИд = СоздатьОбъект("СписокЗначений"); Для Х = 0 По ФормаРасш.КоличествоАтрибутов() - 1 Цикл СписокИд.ДобавитьЗначение(ФормаРасш.ПолучитьАтрибут(Х).Идентификатор()); КонецЦикла; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id145" id="getattrib" name="getattrib">ПолучитьАтрибут / GetAttrib</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьАтрибут(Номер)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Номер - тип: Число или Строка. Порядковый номер атрибута на форме, начиная с нуля. Или строка с идентификатором атрибута формы.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> <a class="reference" href="#attribex">Объект АтрибутФормы / AttribEx</a></p> <p><strong>Описание:</strong> Метод предназначен для получения атрибута формы по порядковому номеру или идентификатору. Для получение доступа к многострочной части формы необходимо в этот метод передать строку "МногострочнаяЧасть".</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.УстановитьФорму(Форма); ФормаРасш.ПолучитьАтрибут(5).Слой = "Основной"; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id146" id="fullpath" name="fullpath">ПолныйПуть / FullPath</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолныйПуть()</p> <p><strong>Возвращает:</strong> тип: Строка.</p> <p><strong>Описание:</strong> Метод предназначен для получения полного пути к потоку, в котором хранится текущая форма.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.УстановитьФорму(Форма); Сообщить(ФормаРасш.ПолныйПуть()); // выводит строку вида: C:\myBASE\1Cv7.MD\CalcVar\CalcVar_Number41 </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id147" id="objecttype" name="objecttype">ТипОбъекта / ObjectType</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ТипОбъекта()</p> <p><strong>Возвращает:</strong> тип: Строка.</p> <p><strong>Описание:</strong> Метод предназначен для получения типа объекта, которому принадлежит текущая форма.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.УстановитьФорму(Форма); Сообщить(ФормаРасш.ТипОбъекта()); // выводит строку вида: Обработка </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id148" id="fullobjecttype" name="fullobjecttype">ПолныйТипОбъекта / FullObjectType</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолныйТипОбъекта()</p> <p><strong>Возвращает:</strong> тип: Строка.</p> <p><strong>Описание:</strong> Метод предназначен для получения строки с описанием полного типа текущей формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.УстановитьФорму(Форма); Сообщить(ФормаРасш.ПолныйТипОбъекта()); // выводит строку вида: Справочник.Тестовый.ФормаСписка.ДляВыбора </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id149" id="fixmultiline" name="fixmultiline">ФиксироватьМногострочнуюЧасть / FixMultiLine</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ФиксироватьМногострочнуюЧасть(Количество)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Количество - тип: Число. Количество фиксируемых колонок многострочной части.</li> </ul> </blockquote> <p><strong>Описание:</strong> Фиксирует заданное количество колонок в многострочной части формы аналогично штатному методу Фиксировать объекта ТаблицаЗначений. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.УстановитьФорму(Форма); ФормаРасш.ФиксироватьМногострочнуюЧасть(2); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id150" id="addattrib" name="addattrib">ДобавитьАтрибут / AddAttrib</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ДобавитьАтрибут(ТипАтрибута)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><dl class="first docutils"> <dt>ТипАтрибута - тип: Число. Задает тип добавляемого атрибута формы и может принимать следующие значения:</dt> <dd><ul class="first last simple"> <li>1 - STATIC (Текст)</li> <li>2 - 1CEDIT (Поле ввода)</li> <li>3 - BUTTON (Кнопка)</li> <li>4 - 1CGROUPBOX (Рамка группы)</li> <li>5 - 1CEDIT (Поле ввода без рамки)</li> <li>11 - LISTBOX (Список)</li> <li>12 - CHECKBOX (Флажок)</li> <li>13 - RADIO (Переключатель)</li> <li>14 - COMBOBOX (Поле со списком)</li> <li>15 - TABLE (Таблица)</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Возвращает:</strong> <a class="reference" href="#attribex">Объект АтрибутФормы / AttribEx</a></p> <p><strong>Описание:</strong> Метод предназначен для добавление атрибутов на текущую форму. <strong>НЕСТАБИЛЬНЫЙ!</strong></p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id151" id="getattribatpos" name="getattribatpos">ПолучитьАтрибутПоКоординатам / GetAttribAtPos</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьАтрибутПоКоординатам(X, Y)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>X - тип: Число. Координата по горизонтальной оси</li> <li>Y - тип: Число. Координата по вертикальной оси</li> </ul> </blockquote> <p><strong>Возвращает:</strong> <a class="reference" href="#attribex">Объект АтрибутФормы / AttribEx</a> или пустое значение</p> <p><strong>Описание:</strong> Метод предназначен для получения атрибута формы по заданным координатам. Если по заданным координатам на форме нет атрибута, то возвращается пустое значение. Если по заданным координатам расположены несколько атрибутов, то возвращается первый из них в соответствии с заданным порядком обхода.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвиженииМыши(сост, х, у) ФормаРасш = СоздатьОбъект("РасширениеФормы"); Атр = ФормаРасш.ПолучитьАтрибутПоКоординатам(х,у); Если ТипЗначенияСтр(Атр) = "АтрибутФормы" Тогда Состояние(" х = "+х+" у = "+у+" сост = "+сост+" :: "+Атр.Заголовок); Иначе Состояние(" х = "+х+" у = "+у+" сост = "+сост); КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id152" id="findattrib" name="findattrib">НайтиАтрибут / FindAttrib</a></h3> <blockquote> <p><strong>Синтаксис:</strong> НайтиАтрибут(ТипФильтра, ЗначениеФильтра)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><dl class="first docutils"> <dt>ТипФильтра - тип: Число. Задает тип фильтра поиска. Возможны следующие значения:</dt> <dd><ul class="first last simple"> <li>1 - по типу атрибута;</li> <li>2 - по заголовку атрибута;</li> <li>3 - по значению видимости атрибута;</li> <li>4 - по значению доступности атрибута;</li> <li>5 - по принадлежности к слою.</li> </ul> </dd> </dl> </li> <li><p class="first">ЗначениеФильтра - тип: Число или Строка. Задает значение фильтра поиска в соответствии с заданным типом.</p> </li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Число. В случае успеха поиска возвращает 1, иначе - 0.</p> <p><strong>Описание:</strong> Осуществляет поиск атрибута в соответствии с заданным условием.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); р = ФормаРасш.НайтиАтрибут(1,3); Пока р = 1 Цикл Сообщить(ФормаРасш.ТекущийАтрибут().Заголовок); р = ФормаРасш.ПолучитьСледующийАтрибут(); КонецЦикла; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id153" id="getnextattrib" name="getnextattrib">ПолучитьСледующийАтрибут / GetNextAttrib</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьСледующийАтрибут()</p> <p><strong>Возвращает:</strong> тип: Число. В случае успеха поиска возвращает 1, иначе - 0.</p> <p><strong>Описание:</strong> Метод предназначен для поиска следующего атрибута в соответствии с параметрами, установленными ранее методом <a class="reference" href="#findattrib">НайтиАтрибут / FindAttrib</a>.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); р = ФормаРасш.НайтиАтрибут(5,"Основной"); Пока р = 1 Цикл Сообщить(ФормаРасш.ТекущийАтрибут().Заголовок); р = ФормаРасш.ПолучитьСледующийАтрибут(); КонецЦикла; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id154" id="currentattrib" name="currentattrib">ТекущийАтрибут / CurrentAttrib</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ТекущийАтрибут()</p> <p><strong>Возвращает:</strong> <a class="reference" href="#attribex">Объект АтрибутФормы / AttribEx</a></p> <p><strong>Описание:</strong> Метод предназначен для получение текущего атрибута. Позиционирование на атрибуте осуществляется методами <a class="reference" href="#findattrib">НайтиАтрибут / FindAttrib</a> и <a class="reference" href="#getnextattrib">ПолучитьСледующийАтрибут / GetNextAttrib</a>.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); р = ФормаРасш.НайтиАтрибут(2,"Выбор"); Пока р = 1 Цикл Сообщить(ФормаРасш.ТекущийАтрибут().Идентификатор); р = ФормаРасш.ПолучитьСледующийАтрибут(); КонецЦикла; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id155" id="getpicture" name="getpicture">ПолучитьКартинку / GetPicture</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьКартинку(Лево, Верх, Ширина, Высота)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Лево - тип: Число. Координата начала вырезаемой области по горизонтальной оси.</li> <li>Верх - тип: Число. Координата начала вырезаемой области по вертикальной оси.</li> <li>Ширина - тип: Число. Ширина вырезаемой области.</li> <li>Высота - тип: Число. Высота вырезаемой области.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> объект Картинка</p> <p><strong>Описание:</strong> Метод предназначен для получения части формы в виде объекта Картинка. Метод работает только после физического открытия и отображения окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПолучитьКартинку(Карт) // процедура вызывается из объекта Картинка, расположенного на печатной форме Перем Лево,Верх,Ширина,Высота; ФормаРасш = СоздатьОбъект("РасширениеФормы"); АтрТекст = СоздатьОбъект("АтрибутФормы"); АтрТекст.УстановитьАтрибут(Форма,"Табл"); АтрТекст.ПолучитьКоординаты(Лево,Верх,Ширина,Высота); Карт.УстановитьКартинку(ФормаРасш.ПолучитьКартинку(Лево,Верх,Ширина,Высота)); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id156" id="highlighttabitem" name="highlighttabitem">ПодсветкаЗакладки / HighlightTabItem</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПодсветкаЗакладки(НомерЗакладки, ВключитьПодсветку)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>НомерЗакладки - тип: Число. Номер закладки, для которой необходимо изменить состояние подсветки;</li> <li>ВключитьПодсветку> - тип: Число. Флаг состояния подсветки: 1 - включить; 0 - выключить;</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для включения/выключения подсветки заданной закладки.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); Форма.ИспользоватьЗакладки(1); Форма.Закладки.ДобавитьЗначение("Основная"); Форма.Закладки.ДобавитьЗначение("Дополнительная"); ФормаРасш.ПодсветкаЗакладки(2, 1); // включаем подсветку закладки "Дополнительная" </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id157" id="addtabimages" name="addtabimages">ДобавитьКартинкиЗакладок / AddTabImages</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ДобавитьКартинкиЗакладок(ИмяКартинки)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>ИмяКартинки - тип: Строка. Идентификатор картинки с пиктограммами в библиотеке картинок конфигурации.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Число. 1 - в случае успешного выполнения, иначе - 0.</p> <p><strong>Описание:</strong> Добавляет на закладки пиктограммы из библиотеки картинок. В библиотеке картинок должна присутствовать картинка в формате bmp с пикторгаммами размером 16х16 пикселей. Пикторгаммы назначаются закладкам по их порядковому номеру. Прозрачным считается цвет RGB(0, 128, 128). При повторных вызовах пикторгаммы из указанной картинки добавляются к тем, которые загружены ранее в закладки. Т.е. библитека пикторгамм на закладках будет увеличиваться. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); Форма.ИспользоватьЗакладки(1); Форма.Закладки.ДобавитьЗначение("Основная"); Форма.Закладки.ДобавитьЗначение("Дополнительная"); ФормаРасш.ДобавитьКартинкиЗакладок("ДляЗакладок"); // в картинке две пиктограммы Форма.Закладки.ДобавитьЗначение("Второстепенная"); // закладка появится без пиктограммы ФормаРасш.ДобавитьКартинкиЗакладок("ДляДопЗакладок"); // добавляется пикторгамма для последней закладки </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id158" id="refreshtabimages" name="refreshtabimages">ОбновитьКартинкиЗакладок / RefreshTabImages</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ОбновитьКартинкиЗакладок()</p> <p><strong>Описание:</strong> Метод предназначен для обновления сопоставления пиктограмм и закладок. Необходимо его вызвать, например, при добавлении новой закладки, для которой уже есть пикторгамма. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); Форма.ИспользоватьЗакладки(1); Форма.Закладки.ДобавитьЗначение("Основная"); Форма.Закладки.ДобавитьЗначение("Дополнительная"); ФормаРасш.ДобавитьКартинкиЗакладок("ДляЗакладок"); // в картинке три пиктограммы Форма.Закладки.ДобавитьЗначение("Второстепенная"); // закладка появится без пиктограммы ФормаРасш.ОбновитьКартинкиЗакладок(); // в результате все закладки с соответсвующими пиктограммами </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id159" id="disablecloseformbybutton" name="disablecloseformbybutton">ЗапретЗакрытияФормыКнопкой / DisableCloseFormByButton</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ЗапретЗакрытияФормыКнопкой(ФлагЗапрета)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>ФлагЗапрета - тип: Число. 1 - сделать недоступной системную кнопку закрытия окна формы; 0 - разрешить закрытие формы по кнопке. Необязательный. По умолчанию доступность системной кнопки не изменяется.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> Значение доступности ситемной кнопки закрытия окна формы до выполнения метода.</p> <p><strong>Описание:</strong> Метод предназначен для получения/установки доступности системной кнопки закрытия окна.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Если Проведен() = 0 Тогда ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.ЗапретЗакрытияФормыКнопкой(1); КонецЕсли; </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id160" id="refresh" name="refresh">Обновить / Refresh</a></h3> <blockquote> <p><strong>Синтаксис:</strong> Обновить()</p> <p><strong>Описание:</strong> Вызывает перерисовку формы. В отличии от штатного одноименного метода объекта Форма не вызывает пересчет формул в форме, а просто перерисовывает окно. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.Обновить(); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id161" id="colourtable" name="colourtable">РаскрашиватьТаблицу / ColourTable</a></h3> <blockquote> <p><strong>Синтаксис:</strong> РаскрашиватьТаблицу(Имя)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Имя - тип: Строка. Идентификатор таблицы на форме. Для многострочной части формы необходимо использовать идентификатор - "МногострочнаяЧасть".</li> </ul> </blockquote> <p><strong>Описание:</strong> Разрешает раскраску указанной таблицы при включенной частичной раскраске. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш = СоздатьОбъект("РасширениеФормы"); ФормаРасш.РаскрашиватьТаблицу("Табл"); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id162" id="attachform" name="attachform">ПрисоединитьФорму / AttachForm</a></h3> <blockquote> <p><strong>Синтаксис 1:</strong> ПрисоединитьФорму(<Положение>,<Форма>) <strong>Синтаксис 2:</strong> ПрисоединитьФорму(<Положение>,...)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><dl class="first docutils"> <dt>Положение - тип: Число. Задает положение присоединяемой формы относительно текущей. Необязательный. Может принимать следующие значения (по умолчанию 1):</dt> <dd><ul class="first last simple"> <li>1 - снизу;</li> <li>2 - справа;</li> <li>3 - сверху;</li> <li>4 - слева.</li> </ul> </dd> </dl> </li> <li><p class="first">Форма - тип: объект Форма. Форма, которую необходимо присоединить.</p> </li> <li><p class="first">Во втором варианте вызова метод работает как процедура ОткрытьФорму(). Соответственно, в этом случае после первого параметра идут параметра аналогичные штатной процедуре. Подробней о параметрах см. в соответствующем разделе документации по 1С:Предприятию.</p> </li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Число. 1 - в случае успешного выполнения, иначе - 0.</p> <p><strong>Описание:</strong> Присоединяет к текущей форме другую отрытую форму. Формы разделяются сплиттером. Метод работает только после физического открытия окна формы. В один момент времени может быть присоединена только одна форма.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Перем Конт; Процедура ПослеОткрытия() Конт = ""; Если Форма.РежимВыбора() = 0 Тогда РФорма = СоздатьОбъект("РасширениеФормы"); Если ОткрытьФорму("Справочник.ЕдиницыИзмерения#",Конт) = 1 Тогда РФорма.ПрисоединитьФорму(,Конт.Форма); КонецЕсли; КонецЕсли; КонецПроцедуры </pre> <pre class="literal-block"> Перем Конт; Процедура ПослеОткрытия() Конт = ""; Если Форма.РежимВыбора() = 0 Тогда РФорма = СоздатьОбъект("РасширениеФормы"); Если РФорма.ПрисоединитьФорму(2,"Справочник.ЕдиницыИзмерения#",Конт) = 0 Тогда Конт = "Ошибка"; КонецЕсли; КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id163" id="detachform" name="detachform">ОтсоединитьФорму / DetachForm</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ОтсоединитьФорму()</p> <p><strong>Описание:</strong> Отсоединяет ранее присоединенную форму и закрывает ее. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриЗакрытии() РФорма = СоздатьОбъект("РасширениеФормы"); РФорма.ОтсоединитьФорму(); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id164" id="tablecolumnposition" name="tablecolumnposition">ПоложениеКолонкиТаблицы / TableColumnPosition</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПоложениеКолонкиТаблицы(Имя, Колонка, Положение)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">Имя - тип: Строка. Идентификатор таблицы значений на форме.</p> </li> <li><p class="first">Колонка - тип: Число. Номер колонки, начиная с нуля, для которой изменяется положение.</p> </li> <li><dl class="first docutils"> <dt>Положение - тип: Число. Новое значение положения колонки. Может принимать следующие значения:</dt> <dd><ul class="first last simple"> <li>0 - новая колонка;</li> <li>1 - в той же колонке;</li> <li>2 - на следующей строке.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Метод служит для изменения положения колонки таблицы значений на форме. Метод работает только после физического открытия окна формы. При установке положения на следующей строке необходимо произвести дополнительные действия: добавить и удалить колонку в таблице. Это вызвано тем, что 1С:Предприятие не распознает сразу, что изменилось количество строк в заголовке таблицы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура Выполнить() РФорма = СоздатьОбъект("РасширениеФормы"); РФорма.ПоложениеКолонкиТаблицы("Табл",3,2); РФорма.ПоложениеКолонкиТаблицы("Табл",4,1); Табл.НоваяКолонка(); Табл.УдалитьКолонку(Табл.КоличествоКолонок()); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id165" id="setautoadjusttable" name="setautoadjusttable">УстановитьАвтоширинуВТаблице / SetAutoAdjustTable</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьАвтоширинуВТаблице(Имя, Флаг)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Имя - тип: Строка. Идентификатор таблицы значений на форме или "МногострочнаяЧасть" для доступа к многострочной части формы.</li> <li>Флаг - новое значение флага автоширины колонок.</li> </ul> </blockquote> <p><strong>Описание:</strong> Снимает/устанавливает флаг автоширины колонок в таблице. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> РФорма = СоздатьОбъект("РасширениеФормы"); РФорма.УстановитьАвтоширинуВТаблице(Табл,0); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id166" id="resetmodify" name="resetmodify">СбросМодифицированности / ResetModify</a></h3> <blockquote> <p><strong>Синтаксис:</strong> СбросМодифицированности()</p> <p><strong>Описание:</strong> Сбрасывает флаг модифицированности для текущей формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id167" id="id30" name="id30">УстановитьКурсор / SetCurcor</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьКурсор(ИмяКурсора)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><dl class="first docutils"> <dt>ИмяКурсора - тип: Число/Строка. Если в качестве параметра передается строковое значение, то оно воспринимается как путь к файлу с курсором. Если ни чего не передавать, то для окна восстанавливается курсор по умолчанию. Если передается числовое значение, то устанавливается системный курсор. Возможные числовые значения (любое другое числовое значение восстанавливает курсор по умолчанию):</dt> <dd><ul class="first last simple"> <li>(значение) - (константа WIndows, которой соответсвует это значение)</li> <li>1 - IDC_ARROW;</li> <li>2 - IDC_IBEAM;</li> <li>3 - IDC_WAIT;</li> <li>4 - IDC_CROSS;</li> <li>5 - IDC_UPARROW;</li> <li>6 - IDC_SIZENWSE;</li> <li>7 - IDC_SIZENESW;</li> <li>8 - IDC_SIZEWE;</li> <li>9 - IDC_SIZENS;</li> <li>10 - IDC_SIZEALL;</li> <li>11 - IDC_NO;</li> <li>12 - IDC_APPSTARTING;</li> <li>13 - IDC_HELP.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для установки пользовательского курсора окну формы. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвиженииМыши(сост, х, у) ФормаРасш = СоздатьОбъект("РасширениеФормы"); Атр = ФормаРасш.ПолучитьАтрибутПоКоординатам(х,у); Если ТипЗначенияСтр(Атр) = "АтрибутФормы" Тогда ФормаРасш.УстановитьКурсор(Число(Атр.Заголовок)); Иначе ФормаРасш.УстановитьКурсор(0); КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id168" id="gettablesname" name="gettablesname">ПолучитьИменаТаблиц / GetTablesName</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьИменаТаблиц()</p> <p><strong>Возвращает:</strong> тип: Строка. Строка с именами таблиц-шаблонов, разделенных переносом строк.</p> <p><strong>Описание:</strong> Метод предназначен для получения имен всех таблиц-шаблонов, заданных для текущей формы в конфигураторе.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id169" id="setcolumnwidth" name="setcolumnwidth">УстановитьШиринуКолонки / SetColumnWidth</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьШиринуКолонки(Имя, НомерКолонки, Ширина)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Имя - тип: Строка. Идентификатор таблицы значений на форме или "МногострочнаяЧасть" для доступа к многострочной части формы.</li> <li>НомерКолонки - тип: Число. Номер колонки, начиная с нуля, для которой изменяется ширина.</li> <li>Ширина - тип: Число. Положительное число - новое значение ширины колонки таблицы.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для установки ширины колонки таблицы в соответствии с заданными параметрами. Метод работает только после физического открытия окна формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id170" id="getcolumnwidth" name="getcolumnwidth">ПолучитьШиринуКолонки / GetColumnWidth</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьШиринуКолонки(Имя, НомерКолонки)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Имя - тип: Строка. Идентификатор таблицы значений на форме или "МногострочнаяЧасть" для доступа к многострочной части формы.</li> <li>НомерКолонки - тип: Число. Номер колонки, начиная с нуля, для которой необходимо получить ширину.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Число. Текущая ширина колонки.</p> <p><strong>Описание:</strong> Метод предназначен для получения ширины колонки таблицы в соответствии с заданными параметрами. Метод работает только после физического открытия окна формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id171" id="getcurrentcellcoordinates" name="getcurrentcellcoordinates">ПолучитьКоординатыТекущейЯчейки / GetCurrentCellCoordinates</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьКоординатыТекущейЯчейки(Имя, Верх, Лево, Низ, Право)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Имя - тип: Строка. Идентификатор таблицы значений на форме или "МногострочнаяЧасть" для доступа к многострочной части формы.</li> <li>Верх - тип: Любой. Переменная для приема координаты текущей ячейки.</li> <li>Лево - тип: Любой. Переменная для приема координаты текущей ячейки.</li> <li>Низ - тип: Любой. Переменная для приема координаты текущей ячейки.</li> <li>Право - тип: Любой. Переменная для приема координаты текущей ячейки.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для получения экранных координа текущей ячейки заданной таблицы (работает и для таблицы, перехваченной объектом "Дерево+Таблица"). Метод работает только после физического открытия окна формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id172" id="getcellcoordinates" name="getcellcoordinates">ПолучитьКоординатыЯчейки / GetCellCoordinates</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьКоординатыЯчейки(Имя, НомерСтроки, НомерКолонки, Верх, Лево, Низ, Право)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Имя - тип: Строка. Идентификатор таблицы значений на форме или "МногострочнаяЧасть" для доступа к многострочной части формы.</li> <li>НомерСтроки - тип: Число. Номер строки таблицы, начиная с нуля, для которой необходимо получить координаты. Для многострочной части формы - это номер среди видимых в данный момент на экране строк. Для объекта "Дерево+Таблица" необходимо передавать полный путь к строке (в этом случае тип параметра будет Строка).</li> <li>НомерКолонки - тип: Число. Номер колонки таблицы, начиная с нуля, для которой необходимо получить координаты.</li> <li>Верх - тип: Любой. Переменная для приема координаты текущей ячейки.</li> <li>Лево - тип: Любой. Переменная для приема координаты текущей ячейки.</li> <li>Низ - тип: Любой. Переменная для приема координаты текущей ячейки.</li> <li>Право - тип: Любой. Переменная для приема координаты текущей ячейки.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для получения экранных координа заданной ячейки заданной таблицы (работает и для таблицы, перехваченной объектом "Дерево+Таблица"). Метод работает только после физического открытия окна формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id173" id="id31" name="id31">ОбработкаОжидания / IdleProcessing</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ОбработкаОжидания(Имя, Интервал)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Имя - тип: Строка. Имя процедуры модуля текущей формы для периодического вызова (если в качестве параметра передается пустая строка, то ранее запущенный процесс прекращается);</li> <li>Интервал - тип: Число. Интервал вызова процедуры в миллисекундах (если в качестве параметра передается 0 (ноль), то ранее запущенный процесс прекращается).</li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Строка. Имя процедуры, которая была установлена ранее в качестве процедуры обработки ожидания.</p> <p><strong>Описание:</strong> Вызывает процедуру модуля формы с заданным интервалом в милисекундах. В отличии от штатной обработки ожидания, вызывается при открытых модальных формах. Для одной формы может быть установлено сколько угодно обработок ожидания путем создания нужного количества объектов РасширениеФормы. При уничтожении объекта, для которого вызывался данный метод, соответствующая процедура обработки ожидания останавливается. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> ФормаРасш1 = СоздатьОбъект("РасширениеФормы"); ФормаРасш1.ОбработкаОжидания("Таймер",100); ФормаРасш2 = СоздатьОбъект("РасширениеФормы"); ФормаРасш2.ОбработкаОжидания("ВывестиТаймер",10000); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id174" id="settablepicture" name="settablepicture">УстановитьКартинкуМногострочнойЧасти / SetTablePicture</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьКартинкуМногострочнойЧасти(ИмяКартинки)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>ИмяКартинки - тип: Строка. Идентификатор картинки в библиотеке картинок для установки.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для подмены системных пиктограмм многострочной части формы списка на пользовательский набор пиктограмм из библиотеки картинок. Установка пиктограмм осуществляется только для первой колонки многострочной части, в которой штатно отображаются системные пиктограммы.</p> </blockquote> </div> </div> </div> <div class="section"> <h1><a class="toc-backref" href="#id175" id="attribex" name="attribex">Объект АтрибутФормы / AttribEx</a></h1> <div class="section"> <h2><a class="toc-backref" href="#id176" id="id32" name="id32">Свойства</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id177" id="caption" name="caption">Заголовок / Caption</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Доступ к значению заголовка атрибута формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id178" id="hint" name="hint">Подсказка / Hint</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Доступ к значению подсказки атрибута формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id179" id="id33" name="id33">Описание / Description</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Доступ к значению описания атрибута формы. Запись возможна только до физического открытия формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id180" id="formula" name="formula">Формула / Formula</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Доступ к значению формулы атрибута формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id181" id="visible" name="visible">Видимость / Visible</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Доступ к значению видимости атрибута формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id182" id="readonly" name="readonly">Доступность / ReadOnly</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Доступ к значению доступности атрибута формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id183" id="layer" name="layer">Слой / Layer</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Доступ к значению принадлежности атрибута формы к слою.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id184" id="type" name="type">Тип / Type</a></h3> <blockquote> <p><strong>Доступ:</strong> только чтение.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Доступ к значению типу контрола атрибута. Возможные значения:</p> <ul class="simple"> <li>1 - STATIC (Текст)</li> <li>2 - 1CEDIT (Поле ввода)</li> <li>3 - BUTTON (Кнопка)</li> <li>4 - 1CGROUPBOX (Рамка группы)</li> <li>5 - 1CEDIT (Колонка многострочной части редактируемая)</li> <li>8 - SysTreeView32 (Дерево групп)</li> <li>9 - STATIC (Колонка многострочной части с пикторгаммой или просто текстовая)</li> <li>10 - PICTURE (Картинка)</li> <li>11 - LISTBOX (Список)</li> <li>12 - CHECKBOX (Флажок)</li> <li>13 - RADIO (Переключатель)</li> <li>14 - COMBOBOX (Поле со списком)</li> <li>15 - TABLE (Таблица)</li> </ul> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id185" id="attribid" name="attribid">Идентификатор / AttribID</a></h3> <blockquote> <p><strong>Доступ:</strong> только чтение.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Доступ к значению идентификатора атрибута.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id186" id="value" name="value">Значение / Value</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> любой.</p> <p><strong>Описание:</strong> Доступ к значению, хранимому в атрибуте.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id187" id="id34" name="id34">ЦветФона / BkColor</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Доступ к цвету фона реквизита. <strong>НЕСТАБИЛЬНЫЙ!</strong></p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id188" id="fontcolor" name="fontcolor">ЦветШрифта / FontColor</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Доступ к цвету шрифта реквизита. <strong>НЕСТАБИЛЬНЫЙ!</strong></p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id189" id="mask" name="mask">Маска / Mask</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Доступ к маске реквизита, если реквизит имеет тип Строка.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id190" id="related" name="related">СвязанС / Related</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Доступ к атрибуту связи реквизита с другим реквизитом на форме, если реквизит имеет тип Справочник.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id191" id="font" name="font">Шрифт / Font</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Доступ к шрифту атрибута. Содержит код шрифта. Новый шрифт можно создать методом <a class="reference" href="#createfont">СоздатьШрифт / CreateFont</a> или <a class="reference" href="#createfontcausedby">СоздатьШрифтНаОсновании / CreateFontCausedBy</a>.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id192" id="class" name="class">Класс / Class</a></h3> <blockquote> <p><strong>Доступ:</strong> только чтение.</p> <p><strong>Тип:</strong> строка.</p> <p><strong>Описание:</strong> Windows-класс окна атрибута формы. Это свойство в основном предназначено для служебных нужд разработчиков компоненты.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id193" id="border" name="border">Рамка / Border</a></h3> <blockquote> <p><strong>Доступ:</strong> чтение и запись.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Доступ к флагу наличия рамки у окна атрибута формы.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id194" id="parentwindow" name="parentwindow">РодительскоеОкно / ParentWindow</a></h3> <blockquote> <p><strong>Доступ:</strong> только запись.</p> <p><strong>Тип:</strong> ссылка на штатный атрибут формы.</p> <p><strong>Описание:</strong> Изменение родительского окна атрибута формы. Предназначен для эмуляции прямого ввода в таблицу значений на форме.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриРедактированииСвойства() тс = ТаблСвойства.ТекущаяСтрока(); Если тс = 0 Тогда Возврат; КонецЕсли; _тк = ТаблСвойства.ТекущаяКолонка(); тк = ТаблСвойства.ПолучитьПараметрыКолонки(_тк); в = ""; л = ""; н = ""; п = ""; РФ.ПолучитьКоординатыЯчейки("ТаблСвойства",тс,тк,в,л,н,п); Атр.УстановитьАтрибут(Форма,_тк); Атр.УстановитьКоординаты(л,в,п-л,н-в); Атр.Рамка = 0; Атр.РодительскоеОкно = Форма.ТаблСвойства; Свойство = ТаблСвойства.ПолучитьЗначение(тс,"Свойство"); Значение = ТаблСвойства.ПолучитьЗначение(тс,"Значение"); Форма.ПолучитьАтрибут(_тк).Видимость(1); Активизировать(_тк,1); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id195" id="handle" name="handle">Дескриптор / Handle</a></h3> <blockquote> <p><strong>Доступ:</strong> только чтение.</p> <p><strong>Тип:</strong> число.</p> <p><strong>Описание:</strong> Windows-дескриптор окна атрибута формы.</p> </blockquote> </div> </div> <div class="section"> <h2><a class="toc-backref" href="#id196" id="id35" name="id35">Методы (для работы с объектом "Дерево+Таблица")</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id197" id="wrapvaluetable" name="wrapvaluetable">ПерехватитьТаблицуЗначений / WrapValueTable</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПерехватитьТаблицуЗначений()</p> <dl class="docutils"> <dt><strong>Описание:</strong> Преобразует таблицу значений на форме в объект "Дерево+Таблица". Преобразуемая ТЗ должна иметь строго определенную структуру: первые три колонки служебные, остальные произвольные. Служебные колонки:</dt> <dd><ul class="first last simple"> <li>1: содержит ТЗ той же структуры со следующим уровнем дерева,</li> <li>2: содержит номер пиктограммы, из установленной на перехватываемой ТЗ картинки, для отображения в дереве (если нулевое значение, то используются системные пиктограммы),</li> <li>3: содержит наименование ветви дерева.</li> </ul> </dd> </dl> <p>Метод работает только после физического открытия окна формы. Все методы для работы с объектом "Дерево+Таблица" работают только после вызова этого метода.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id198" id="updatetree" name="updatetree">ОбновитьДерево / UpdateTree</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ОбновитьДерево()</p> <p><strong>Описание:</strong> Обновляет объект "Дерево+Таблица" данными из перехватываемой ТЗ.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> АтрФормы = СоздатьОбъект("АтрибутФормы"); АтрФормы.УстановитьАтрибут(Форма,"Табл"); АтрФормы.ОбновитьДерево(); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id199" id="currenttreeitem" name="currenttreeitem">ТекущаяСтрокаДерева / CurrentTreeItem</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ТекущаяСтрокаДерева()</p> <p><strong>Возвращает:</strong> тип: Строка. Полный путь к текущей строке в дереве.</p> <p><strong>Описание:</strong> Метод предназначен для получение полного пути текущей строки дерева.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> АтрФормы = СоздатьОбъект("АтрибутФормы"); АтрФормы.УстановитьАтрибут(Форма,"Табл"); Сообщить(АтрФормы.ТекущаяСтрокаДерева(); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id200" id="currenttreecolumn" name="currenttreecolumn">ТекущаяКолонкаДерева / CurrentTreeColumn</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ТекущаяКолонкаДерева()</p> <p><strong>Возвращает:</strong> тип: Число. Номер текущей колонки объекта "Дерево+Таблица".</p> <p><strong>Описание:</strong> Метод предназначен для получения номера текущей колонки.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> АтрФормы = СоздатьОбъект("АтрибутФормы"); АтрФормы.УстановитьАтрибут(Форма,"Табл"); Сообщить(АтрФормы.ТекущаяКолонкаДерева(); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id201" id="valuefromtree" name="valuefromtree">ЗначениеИзДерева / ValueFromTree</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ЗначениеИзДерева(Строка, Колонка)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Строка - тип: Строка. Полный путь к строке.</li> <li>Колонка - тип: Число. Номер колонки.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Любой. Значение, хранящееся в объекте "Дерево+Таблица" по указанным в параметрах координатам.</p> <p><strong>Описание:</strong> Метод предназначен для получения значения из объекта "Дерево+Таблица" по полному пути к строке и номеру колонки.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id202" id="valuetotree" name="valuetotree">ЗначениеВДерево / ValueToTree</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ЗначениеВДерево(Строка, Колонка, Значение)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Строка - тип: Строка. Полный путь к строке.</li> <li>Колонка - тип: Число. Номер колонки.</li> <li>Значение - тип: Любой. Значение, которое надо установить в указанную ячейку.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Число. В случае успешного выполнения возвращает 1, иначе - 0.</p> <p><strong>Описание:</strong> Метод предназначен для установки нового значения в объекте "Дерево+Таблица" в ячейку, соответствующую координатам, указанным в параметрах.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id203" id="expandnode" name="expandnode">РазвернутьУзел / ExpandNode</a></h3> <blockquote> <p><strong>Синтаксис:</strong> РазвернутьУзел(Строка)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Строка - тип: Строка. Полный путь к строке. Если пустая, то выполняется для текущей строки.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для разворачивания узла объекта "Дерево+Таблица", расположенного по указанному в параметре пути.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id204" id="collapsenode" name="collapsenode">СвернутьУзел / CollapseNode</a></h3> <blockquote> <p><strong>Синтаксис:</strong> СвернутьУзел(Строка)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Строка - тип: Строка. Полный путь к строке. Если пустая, то выполняется для текущей строки.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для сворачивания узла объекта "Дерево+Таблица", расположенного по указанному в параметре пути.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id205" id="isgroupnode" name="isgroupnode">ЭтоГруппа / IsGroupNode</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ЭтоГруппа(Строка)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Строка - тип: Строка. Полный путь к строке. Если пустая, то выполняется для текущей строки.</li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Число. Если по указанному пути расположен узел, то возвращает 1, иначе - 0.</p> <p><strong>Описание:</strong> Проверяет является ли группой заданная строка объекта "Дерево+Таблица".</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id206" id="setcurrentnode" name="setcurrentnode">УстановитьТекущийУзел / SetCurrentNode</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьТекущийУзел(Строка)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Строка - тип: Строка. Полный путь к строке. Если пустая, то выполняется для текущей строки.</li> </ul> </blockquote> <p><strong>Описание:</strong> Делает заданную строку объекта "Дерево+Таблица" текущей.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id207" id="treecolumnname" name="treecolumnname">ИдентификаторКолонкиДерева / TreeColumnName</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ИдентификаторКолонкиДерева(НомерКолонки)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>НомерКолонки - тип: Число. Номер колонки перехватываемой таблицы значений (начиная с 1).</li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Строка. Идентификатор колонки.</p> <p><strong>Описание:</strong> Метод предназначен для получения идентификатора колонки терехваченной таблицы значений по ее номеру.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id208" id="getvaluetablecolumnnum" name="getvaluetablecolumnnum">ПолучитьНомерКолонкиТаблицыЗначений / GetValueTableColumnNum</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьНомерКолонкиТаблицыЗначений(НомерКолонки)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>НомерКолонки - тип: Число. Номер колонки объекта .</li> </ul> </blockquote> <p><strong>Возвращает:</strong> тип: Число. Номер колонки перехватываемой таблицы значений.</p> <p><strong>Описание:</strong> Метод предназначен для преобразования номера колонки объекта "Дерево+Таблица" в номер колонки перехватываемой этим объектом таблицы значений. Необходимость этого метода вызвана тем, что объект "Дерево+Таблица" содержит только видимы колонки. Соответственно и нумерация колонок перехватываемой таблицы значения и самого объекта не совпадают.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id209" id="treeoptions" name="treeoptions">ОпцииДерева / TreeOptions</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ОпцииДерева(ГоризонтальныеЛинии, ВертикальныеЛинии, ЛинииСвязки)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>ГоризонтальныеЛинии - тип: Число. Флаг отображения горизонтальных линий таблицы. Если 0, то не отображать. Если отрицательно число или не указано, то опция не меняется. Необязательный.</li> <li>ВертикальныеЛинии - тип: Число. Флаг отображения вертикальных линий таблицы. Если 0, то не отображать. Если отрицательно число или не указано, то опция не меняется. Необязательный.</li> <li>ЛинииСвязки - тип: Число. Флаг отображения связующих линий дерева. Если 0, то не отображать. Если отрицательно число или не указано, то опция не меняется. Необязательный.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для установки опций отображения объекта "Дерево+Таблица".</p> </blockquote> </div> </div> <div class="section"> <h2><a class="toc-backref" href="#id210" id="id36" name="id36">Методы</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id211" id="assignattrib" name="assignattrib">УстановитьАтрибут / AssignAttrib</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьАтрибут(Форма, Номер)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Форма - тип: Форма. Штатный объект Форма, который можно получить через служебное свойство "Форма" контекста формы.</li> <li>Номер - тип: Число или Строка. Порядковый номер атрибута на форме, начиная с нуля. Или строка с идентификатором атрибута формы.</li> </ul> </blockquote> <p><strong>Описание:</strong> Устанавливает связь объекта с атрибутом формы. Для получение доступа к многострочной части формы необходимо в этот метод передать строку "МногострочнаяЧасть".</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> АтрФормы = СоздатьОбъект("АтрибутФормы"); АтрФормы.УстановитьАтрибут(Форма,3); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id212" id="id37" name="id37">ПолучитьФорму / GetForm</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьФорму()</p> <p><strong>Возвращает:</strong> штатный объект Форма.</p> <p><strong>Описание:</strong> Метод предназначен для получения количества атрибутов формы, к которой привязан текущий объект.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Фрм = АтрФормы.ПолучитьФорму(); Фрм.Обновить(1); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id213" id="valuetypestr" name="valuetypestr">ТипЗначенияСтр / ValueTypeStr</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ТипЗначенияСтр()</p> <p><strong>Возвращает:</strong> тип: Строка. Тип значение, хранимого в атрибуте формы.</p> <p><strong>Описание:</strong> Метод предназначен для получения в строковом виде типа значения, которое хранится в атрибуте формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> АтрФормы = СоздатьОбъект("АтрибутФормы"); АтрФормы.УстановитьАтрибут(Форма,3); Сообщить("Тип: " + АтрФормы.ТипЗначенияСтр()); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id214" id="getcoordinates" name="getcoordinates">ПолучитьКоординаты / GetCoordinates</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьКоординаты(Лево, Верх, Ширина, Высота)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Лево - тип: Любой. Переменная для приема значения расстояния от левой границы формы до левой границы атрибута. Необязательный.</li> <li>Верх - тип: Любой. Переменная для приема значения расстояния от верхней границы формы до верхней границы атрибута. Необязательный.</li> <li>Ширина - тип: Любой. Переменная для приема значения ширины атрибута. Необязательный.</li> <li>Высота - тип: Любой. Переменная для приема значения высоты атрибута. Необязательный.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод позволяет получить в переданные переменные значения положения и размера атрибута на экране.</p> <p><strong>Пример:</strong></p> <p>АтрФормы = СоздатьОбъект("АтрибутФормы"); АтрФормы.УстановитьАтрибут(Форма,3); Лево=0; Верх=0; Ширина=0; Высота=0; АтрФормы.ПолучитьКоординаты(Лево, Верх, Ширина, Высота);</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id215" id="setcoordinates" name="setcoordinates">УстановитьКоординаты / SetCoordinates</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьКоординаты(Лево, Верх, Ширина, Высота)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Лево - тип: Число. Расстояние от левой границы формы до левой границы атрибута. Необязательный. По умолчанию не меняется.</li> <li>Верх - тип: Число. Расстояние от верхней границы формы до верхней границы атрибута. Необязательный. По умолчанию не меняется.</li> <li>Ширина - тип: Число. Ширина атрибута. Необязательный. По умолчанию не меняется.</li> <li>Высота - тип: Число. Высота атрибута. Необязательный. По умолчанию не меняется.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод позволяет установить новые значения положения и размера атрибута на экране.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> АтрФормы = СоздатьОбъект("АтрибутФормы"); АтрФормы.УстановитьАтрибут(Форма,3); Высота=0; АтрФормы.ПолучитьКоординаты(,,,Высота); АтрФормы.УстановитьКоординаты(,,,Высота+40); </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id216" id="wrapvaluelist" name="wrapvaluelist">ПерехватитьСписокЗначений / WrapValueList</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПерехватитьСписокЗначений()</p> <p><strong>Описание:</strong> Добавляет в список значений на форме (поле со списком) возможность ручного набора. Метод работает только после физического открытия окна формы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПослеОткрытия() АтрФормы = СоздатьОбъект("АтрибутФормы"); АтрФормы.УстановитьАтрибут(Форма,"VL"); АтрФормы.ПерехватитьСписокЗначений(); КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id217" id="id38" name="id38">УстановитьКурсор / SetCurcor</a></h3> <blockquote> <p><strong>Синтаксис:</strong> УстановитьКурсор(ИмяКурсора)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><dl class="first docutils"> <dt>ИмяКурсора - тип: Число/Строка. Если в качестве параметра передается строковое значение, то оно воспринимается как путь к файлу с курсором. Если ни чего не передавать, то для окна восстанавливается курсор по умолчанию. Если передается числовое значение, то устанавливается системный курсор. Возможные числовые значения (любое другое числовое значение восстанавливает курсор по умолчанию):</dt> <dd><ul class="first last simple"> <li>(значение) - (константа WIndows, которой соответсвует это значение)</li> <li>1 - IDC_ARROW;</li> <li>2 - IDC_IBEAM;</li> <li>3 - IDC_WAIT;</li> <li>4 - IDC_CROSS;</li> <li>5 - IDC_UPARROW;</li> <li>6 - IDC_SIZENWSE;</li> <li>7 - IDC_SIZENESW;</li> <li>8 - IDC_SIZEWE;</li> <li>9 - IDC_SIZENS;</li> <li>10 - IDC_SIZEALL;</li> <li>11 - IDC_NO;</li> <li>12 - IDC_APPSTARTING;</li> <li>13 - IDC_HELP.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для установки пользовательского курсора главному окну программы.</p> <p><strong>Пример:</strong></p> </blockquote> <pre class="literal-block"> Процедура ПриДвиженииМыши(сост, х, у) ФормаРасш = СоздатьОбъект("РасширениеФормы"); Атр = ФормаРасш.ПолучитьАтрибутПоКоординатам(х,у); Если ТипЗначенияСтр(Атр) = "АтрибутФормы" Тогда Атр.УстановитьКурсор(Число(Атр.Заголовок)); КонецЕсли; КонецПроцедуры </pre> </div> <div class="section"> <h3><a class="toc-backref" href="#id218" id="createcontrol" name="createcontrol">СоздатьЭлементУправления / CreateControl</a></h3> <blockquote> <p><strong>Синтаксис:</strong> СоздатьЭлементУправления(ЭлементУправления)</p> <dl class="docutils"> <dt><strong>Параметры:</strong></dt> <dd><ul class="first last simple"> <li>ЭлементУправления - тип: Строка, Объект. Если передается строка, то она воспринимается как имя класса для создания нового ЭУ. Если передается Объект, этот объект должен быть ЭУ или КОПом наследником от ЭУ.</li> </ul> </dd> </dl> <p><strong>Возвращает:</strong> тип: Объект. Если передана строка - созданный объект ЭУ, иначе то что передавалось параметром.</p> <p><strong>Описание:</strong> Создает элемент управления на форме. Форма должна существовать.</p> <p>Если передается Строка - производится попытка создать объект переданного переданного типа, если этот объект не является ЭУ - возникает исключение. Если передается объект КОПа, производится попытка найти класс ЭУ среди базовых классов по всей иерархии (т.е. допустимо не прямое наследование от класса ЭУ). Поиск продолжается до первого подходящего класса. После этого полученный объект ставится в соответствие реквизиту формы и создается окно ЭУ.</p> <p><strong>Примечание:</strong> метод существует только в составе 1с++ и не существует в FormEx в самостоятельном варианте библиотеки.</p> <p><strong>Пример:</strong></p> <pre class="literal-block"> ТП = АтрибутФормы.СоздатьЭлементУправления("ТабличноеПоле"); ТП = АтрибутФормы.СоздатьЭлементУправления(СоздатьОбъект("ТабличноеПоле")); ТП = СоздатьОбъект("ТабличноеПолеДляСправочников"); //КОП наследник от ТабличногоПоля ТП.УстановитьСправочник("Контрагенты"); АтрибутФормы.СоздатьЭлементУправления(ТП); </pre> <p>См. также: <a class="reference" href="alink">создаваемые ЭУ|_1cpp_formex_cc_target_</a></p> </blockquote> <chminfo> <alinks>_1cpp_Formex_CreateControl_</alinks> <seealso> _1cpp_formex_cc_target_ </seealso> </chminfo> </div> </div> </div> <div class="section"> <h1><a class="toc-backref" href="#id219" id="windows" name="windows">Объект Окна / Windows</a></h1> <div class="section"> <h2><a class="toc-backref" href="#id220" id="id39" name="id39">Методы</a></h2> <div class="section"> <h3><a class="toc-backref" href="#id221" id="getmenu" name="getmenu">ПолучитьМеню / GetMenu</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьМеню()</p> <p><strong>Возвращает:</strong> тип: СписокЗначений.</p> <p><strong>Описание:</strong> Метод предназначен для получения главного меню программы в виде списка значений. В представлении помещается строка с текстом пункта меню, в значении - числовой идентификатор пункта меню или список значений, если текущий пункт - это подменю. Уровень вложения списков значений ограничен только количеством вложенных подменю.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id222" id="enablemenu" name="enablemenu">ДоступностьМеню / EnableMenu</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ДоступностьМеню(ИмяПунктаМеню, ФлагДоступности)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">ИмяПунктаМеню - тип: Строка. Имя пункта меню или подменю в полном виде. Примером полного вида служит представление в список значений, возвращаемый методом <a class="reference" href="#getmenu">ПолучитьМеню / GetMenu</a>.</p> </li> <li><dl class="first docutils"> <dt>ФлагДоступности - тип: Число. Флаг доступности пункта меню:</dt> <dd><ul class="first last simple"> <li>1 - пункт меню становится доступным;</li> <li>0 - запрещается доступ к пункту меню.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Устанавливает доступность пункта меню или подменю по имени.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id223" id="visiblemenu" name="visiblemenu">ВидимостьМеню / VisibleMenu</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВидимостьМеню(ИмяПунктаМеню, ФлагВидимости)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">ИмяПунктаМеню - тип: Строка. Имя пункта меню или подменю в полном виде. Примером полного вида служит представление в список значений, возвращаемый методом <a class="reference" href="#getmenu">ПолучитьМеню / GetMenu</a>.</p> </li> <li><dl class="first docutils"> <dt>ФлагВидимости - тип: Число. Флаг видимости пункта меню:</dt> <dd><ul class="first last simple"> <li>1 - пункт меню становится видимым;</li> <li>0 - пункту меню скрывается.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Возвращает:</strong></p> <p><strong>Описание:</strong> Устанавливает видимость пункта меню или подменю по имени. Дейстивя метода распространяется как на главное меню программы, так и на все контекстные меню. Если между двумя разделителями в меню нет ни одного видимого пункта, то один из разделителей так же скрывается.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id224" id="gettoolbars" name="gettoolbars">ПолучитьПанели / GetToolBars</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьПанели()</p> <p><strong>Возвращает:</strong> тип: СписокЗначений.</p> <p><strong>Описание:</strong> Метод предназначен для получения списка всех панелей программы в виде объекта СписокЗначений. В представлении возвращаемого списка значений помещается строка с наименованием панели, в значении - флаг видимости соответствующей панели.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id225" id="showtoolbar" name="showtoolbar">ПоказыватьПанель / ShowToolBar</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПоказыватьПанель(ИмяПанели, ФлагВидимости)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">ИмяПанели - тип: Строка. Имя панели в тектовом виде.</p> </li> <li><dl class="first docutils"> <dt>ФлагВидимости - тип: Число. Флаг видимости панели:</dt> <dd><ul class="first last simple"> <li>1 - панель становится видимой;</li> <li>0 - панель скрывается.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Устанавливает видимость панели по имени.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id226" id="showtoolbars" name="showtoolbars">ПоказыватьПанели / ShowToolBars</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПоказыватьПанели(ФлагВидимости)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><dl class="first docutils"> <dt>ФлагВидимости - тип: Число. Флаг видимости панелей:</dt> <dd><ul class="first last simple"> <li>1 - панели становятся видимыми;</li> <li>0 - панели скрываются.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Устанавливает видимость всех панелей программы сразу.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id227" id="showstatusbar" name="showstatusbar">ПоказыватьСтрокуСостояния / ShowStatusBar</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПоказыватьСтрокуСостояния(ФлагВидимости)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><dl class="first docutils"> <dt>ФлагВидимости - тип: Число. Флаг видимости строки состояния:</dt> <dd><ul class="first last simple"> <li>1 - строка состояния отображается;</li> <li>0 - строка состояния скрыта.</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Устанавливает видимость строки состояния.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id228" id="windowsstyle" name="windowsstyle">СтильОкна / WindowsStyle</a></h3> <blockquote> <p><strong>Синтаксис:</strong> СтильОкна(Форма, Стиль)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">Форма - тип: штатный объект Форма. Форма, для окна которой необходимо установить стиль. Необязательный. По умолчанию - главное окно программы.</p> </li> <li><dl class="first docutils"> <dt>Стиль - тип: Число. Новый стиль окна. Допустимые значения:</dt> <dd><ul class="first last simple"> <li>0 - устанавливается штатный стиль окна;</li> <li>1 - для окна отключается стиль WS_BORDER;</li> <li>2 - у окна полностью отключается рамка вместе с системным заголовком;</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Устанавливает необходимый стиль для заданного окна.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id229" id="windowssize" name="windowssize">РазмерОкна / WindowsSize</a></h3> <blockquote> <p><strong>Синтаксис:</strong> РазмерОкна(Форма, Ширина, Высота, Стиль)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul> <li><p class="first">Форма - тип: штатный объект Форма. Форма, для окна которой необходимо установить стиль. Необязательный. По умолчанию - главное окно программы.</p> </li> <li><p class="first">Ширина - тип: Число. Новое значение ширины окна, в переменную возвращается значение ширины до вызова метода. Необязательный. По умолчанию значение не изменяется. Если необходимо просто получить значение ширины, то на входе значение этой переменной должно быть меньше или равно нулю.</p> </li> <li><p class="first">Высота - тип: Число. Новое значение высоты окна, в переменную возвращается значение высоты до вызова метода. Необязательный. По умолчанию значение не изменяется. Если необходимо просто получить значение высоты, то на входе значение этой переменной должно быть меньше или равно нулю.</p> </li> <li><dl class="first docutils"> <dt>Стиль - тип: Число. Устанавливает стиль окна. Необязательный. По умолчанию стильне меняется. Имеет смысл только для главного окна программы. Допыстимые значения:</dt> <dd><ul class="first last simple"> <li>1 - у окна полностью отключается рамка вместе с системным заголовком;</li> <li>2 - устанавливается штатный стиль окна;</li> </ul> </dd> </dl> </li> </ul> </blockquote> <p><strong>Описание:</strong> Установить/получить размер заданного окна.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id230" id="windowspos" name="windowspos">ПоложениеОкна / WindowsPos</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПоложениеОкна(Форма, Лево, Верх)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Форма - тип: штатный объект Форма. Форма, для окна которой необходимо установить стиль. Необязательный. По умолчанию - главное окно программы.</li> <li>Лево - тип: Число. Новое значение координаты окна по горизонтали, в переменную возвращается значение координаты до вызова метода. Необязательный. По умолчанию значение не изменяется. Если необходимо просто получить значение координаты, то на входе значение этой переменной должно быть меньше или равно нулю.</li> <li>Верх - тип: Число. Новое значение координаты окна по вертикали, в переменную возвращается значение координаты до вызова метода. Необязательный. По умолчанию значение не изменяется. Если необходимо просто получить значение координаты, то на входе значение этой переменной должно быть меньше или равно нулю.</li> </ul> </blockquote> <p><strong>Описание:</strong> Установить/получить положение заданного окна.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id231" id="windowsmenu" name="windowsmenu">МенюОкна / WindowsMenu</a></h3> <blockquote> <p><strong>Синтаксис:</strong></p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Форма - тип: штатный объект Форма. Форма, для окна которой необходимо установить стиль. Необязательный. По умолчанию - главное окно программы.</li> <li>Закрыть - тип: Число. Флаг видимости пункта "Закрыть" системного меню: 1 - пункт видим; 0 - пункт скрыт.</li> <li>Максимизировать - тип: Число. Флаг видимости пункта "Максимизировать" системного меню: 1 - пункт видим; 0 - пункт скрыт.</li> <li>Минимизировать - тип: Число. Флаг видимости пункта "Минимизировать" системного меню: 1 - пункт видим; 0 - пункт скрыт.</li> <li>Восстановить - тип: Число. Флаг видимости пункта "Восстановить" системного меню: 1 - пункт видим; 0 - пункт скрыт.</li> </ul> </blockquote> <p><strong>Описание:</strong> Управление системным меню окна. Системное меню - это меню, которое появляется при клике в левом верхнем углу формы. Пункты этого меню жестко связаны с кнопками в правом верхнем углу окна и при установке невидимости пункту меню соответствующая кнопка становится недоступной.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id232" id="centerwindow" name="centerwindow">ЦентрироватьОкно / CenterWindow</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ЦентрироватьОкно(Форма)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Форма - тип: штатный объект Форма. Форма, для окна которой необходимо установить стиль. Необязательный. По умолчанию - главное окно программы.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод предназначен для центрирования заданного окна на экране.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id233" id="id40" name="id40">Максимизировать / Maximize</a></h3> <blockquote> <p><strong>Синтаксис:</strong> Максимизировать(Форма)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Форма - тип: штатный объект Форма. Форма, для окна которой необходимо установить стиль. Необязательный. По умолчанию - главное окно программы.</li> </ul> </blockquote> <p><strong>Описание:</strong> Максимизирование заданного окна, если окно позволяет себя максимизировать.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id234" id="id41" name="id41">Минимизировать / Minimize</a></h3> <blockquote> <p><strong>Синтаксис:</strong> Минимизировать(Форма)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Форма - тип: штатный объект Форма. Форма, для окна которой необходимо установить стиль. Необязательный. По умолчанию - главное окно программы.</li> </ul> </blockquote> <p><strong>Описание:</strong> Минимизирование заданного окна, если окно позволяет себя минимизировать.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id235" id="restore" name="restore">Восстановить / Restore</a></h3> <blockquote> <p><strong>Синтаксис:</strong> Восстановить(Форма)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Форма - тип: штатный объект Форма. Форма, для окна которой необходимо установить стиль. Необязательный. По умолчанию - главное окно программы.</li> </ul> </blockquote> <p><strong>Описание:</strong> Восстановление предыдущего состояния заданного окна после минимизации или максимизации, если окно позволяет себя восстанавливать.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id236" id="getresolution" name="getresolution">ПолучитьРазрешение / GetResolution</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ПолучитьРазрешение(Горизонтальное, Вертикальное)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Горизонтальное - тип: Любой. Переменная для приема значения текущего разрешения экрана по горизонтали.</li> <li>Вертикальное - тип: Любой. Переменная для приема значения текущего разрешения экрана по вертикали.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод позволяет получить текущее разрешение экрана.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id237" id="bringwindowtotop" name="bringwindowtotop">НаПереднийПлан / BringWindowToTop</a></h3> <blockquote> <p><strong>Синтаксис:</strong> НаПереднийПлан(Форма)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Форма - тип: штатный объект Форма. Форма, для окна которой необходимо установить стиль. Необязательный. По умолчанию - главное окно программы.</li> </ul> </blockquote> <p><strong>Описание:</strong> Метод позволяет выдвинуть заданное окно на передний план, если это возможно.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id238" id="beginmodalstate" name="beginmodalstate">ВключитьМодальныйРежим / BeginModalState</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВключитьМодальныйРежим()</p> <p><strong>Описание:</strong> Метод позволяет сделать главное окно модальным для системы. После включения модального режима становятся недоступны любые другие запущенные приложения и панель задач.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id239" id="endmodalstate" name="endmodalstate">ВыключитьМодальныйРежим / EndModalState</a></h3> <blockquote> <p><strong>Синтаксис:</strong> ВыключитьМодальныйРежим()</p> <p><strong>Описание:</strong> Метод позволяет отключить модальный режим, установленный ранее методом <a class="reference" href="#beginmodalstate">ВключитьМодальныйРежим / BeginModalState</a>.</p> </blockquote> </div> <div class="section"> <h3><a class="toc-backref" href="#id240" id="minimizetotray" name="minimizetotray">МинимизироватьВТрей / MinimizeToTray</a></h3> <blockquote> <p><strong>Синтаксис:</strong> МинимизироватьВТрей(Флаг)</p> <p><strong>Параметры:</strong></p> <blockquote> <ul class="simple"> <li>Флаг - тип: Число. Флаг разрешения минимизации главного окна в трей: 1 - разрешитьминимизацию в трей, 0 - запретить.</li> </ul> </blockquote> </blockquote> </div> </div> </div> </div> </body> </html>