Общего назначения клиент УХ

ПоказатьПредупреждениеУниверсально

Описание, пример вызова

////////////////////////////////////////////////////////////////////////////////
// Клиентские процедуры общего назначения

// Устарела. Следует использовать платформенный метод ПоказатьПредупреждение
Процедура ПоказатьПредупреждениеУниверсально(ТекстПредупреждения, Заголовок = Неопределено, Оповещение = Неопределено) Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.ПоказатьПредупреждениеУниверсально(ТекстПредупреждения, Заголовок, Оповещение);

ПоказатьПомещениеФайла

Описание, пример вызова

// Показывает диалог выбора файлов и помещает выбранные файлы во временное хранилище.
//  Совмещает работу методов глобального метода НачатьПомещениеФайла и ПоместитьФайлы,
//  возвращая идентичный результат вне зависимости от того, подключено расширение работы с файлами, или нет.
//
// Параметры:
//   ОбработчикЗавершения  - ОписаниеОповещения - Описание процедуры, принимающей результат выбора.
//   ИдентификаторФормы    - УникальныйИдентификатор - Уникальный идентификатор формы, из которой выполняется
//                                                     размещение файла.
//   НачальноеИмяФайла     - Строка - Полный путь и имя файла, которые будут предложены пользователю в начале выбора.
//   ПараметрыДиалога      - Структура, Неопределено - См. свойства ДиалогВыбораФайла в синтакс-помощнике.
//       Используется в случае, если удалось подключить расширение работы с файлами.
//
// Значение первого параметра, возвращаемого в ОбработчикРезультата:
//   ПомещенныеФайлы - Результат выбора.
//       * - Неопределено - Пользователь отказался от выбора.
//       * - Массив из ОписаниеПереданногоФайла, Структура - Пользователь выбрал файл.
//           ** Имя      - Строка - Полное имя выбранного файла.
//           ** Хранение - Строка - Адрес во временном хранилище, по которому размещен файл.
//
// Ограничения:
//   Используется только для интерактивного выбора в диалоге.
//   Не используется для выбора каталогов - эта опция не поддерживается веб-клиентом.
//   Не поддерживается множественный выбор в веб-клиенте, если не установлено расширение работы с файлами.
//   Не поддерживается передача адреса временного хранилища.
//
Процедура ПоказатьПомещениеФайла(ОбработчикЗавершения, ИдентификаторФормы, НачальноеИмяФайла, ПараметрыДиалога) Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.ПоказатьПомещениеФайла(ОбработчикЗавершения, ИдентификаторФормы, НачальноеИмяФайла, ПараметрыДиалога)

ПоказатьВопросОбУстановкеРасширенияРаботыСФайлами

Описание, пример вызова

// Предлагает пользователю установить расширение работы с файлами в веб-клиенте.
//
// Предназначена для использования в начале участков кода, в которых ведется работа с файлами.
// Например:
//
//    Оповещение = Новый ОписаниеОповещения("ПечатьДокументаЗавершение", ЭтотОбъект);
//    ТекстСообщения = НСтр("ru = 'Для печати документа необходимо установить расширение работы с файлами.'");
//    ОбщегоНазначенияКлиент.ПоказатьВопросОбУстановкеРасширенияРаботыСФайлами(Оповещение, ТекстСообщения);
//
//    Процедура ПечатьДокументаЗавершение(РасширениеПодключено, ДополнительныеПараметры) Экспорт
//      Если РасширениеПодключено Тогда
//        // код печати документа, рассчитывающий на то, что расширение подключено.
//        // ...
//      Иначе
//        // код печати документа, который работает без подключенного расширения.
//        // ...
//      КонецЕсли;
//
// Параметры:
//   ОписаниеОповещенияОЗакрытии    - ОписаниеОповещения - описание процедуры,
//                                    которая будет вызвана после закрытия формы со следующими параметрами:
//                                      РасширениеПодключено    - Булево - Истина, если расширение было подключено.
//                                      ДополнительныеПараметры - Произвольный - параметры, заданные в
//                                                                               ОписаниеОповещенияОЗакрытии.
//   ТекстПредложения                - Строка - текст сообщения. Если не указан, то выводится текст по умолчанию.
//   ВозможноПродолжениеБезУстановки - Булево - если Истина, будет показана кнопка ПродолжитьБезУстановки,
//                                              если Ложь, будет показана кнопка Отмена.
//
Процедура ПоказатьВопросОбУстановкеРасширенияРаботыСФайлами(ОписаниеОповещенияОЗакрытии, ТекстПредложения = "", Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.ПоказатьВопросОбУстановкеРасширенияРаботыСФайлами(ОписаниеОповещенияОЗакрытии, ТекстПредложения, );

ОткрытьФормуРедактированияКомментария

Описание, пример вызова

////////////////////////////////////////////////////////////////////////////////
// Функции для обработки действий пользователя в процессе редактирования
// многострочного текста, например комментария в документах

// Открывает форму редактирования многострочного комментария модально
//
// Параметры:
// МногострочныйТекст      - Строка - произвольный текст, который необходимо отредактировать
// РезультатРедактирования - Строка - переменная, в которую будет помещен результат редактирования
// Модифицированность       - Строка - флаг модифицированности формы
//
Процедура ОткрытьФормуРедактированияКомментария(Форма, Знач МногострочныйТекст, РезультатРедактирования, Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.ОткрытьФормуРедактированияКомментария(Форма, МногострочныйТекст, РезультатРедактирования, );

ОткрытьФормуРедактированияМногострочногоТекста

Описание, пример вызова

// Открывает форму редактирования произвольного многострочного текста модально
//
// Параметры:
// МногострочныйТекст      - Строка - произвольный текст, который необходимо отредактировать
// РезультатРедактирования - Строка - реквизит формы, в которую будет помещен результат редактирования
//  можно адресовать реквизиты через точку, а также обращаться к строкам коллекций через [].
//  ИСКЛЮЧЕНИЕ: "Комментарий" - всегда будет развернут в "Объект.Комментарий".
//  Примеры:
//    "ТекстКомменатрия"
//    "Объект.Комментарий"
//    "Объект.ТаблицаСКомментарием[3].Комментарий"
// Модифицированность       - Строка - флаг модифицированности формы
// Заголовок               - Строка - текст, который необходимо отобразить в заголовке формы
//
Процедура ОткрытьФормуРедактированияМногострочногоТекста(Форма, Знач МногострочныйТекст, РезультатРедактирования, Модифицированность = Ложь, Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.ОткрытьФормуРедактированияМногострочногоТекста(Форма, МногострочныйТекст, РезультатРедактирования, Модифицированность, );

Подключаемый_УстановитьТекст

Описание, пример вызова

Процедура Подключаемый_УстановитьТекст(ТекстКомментария, ПараметрыОповещения = Неопределено) Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.Подключаемый_УстановитьТекст(ТекстКомментария, ПараметрыОповещения);

УстановитьЗнчениеРеквизитаПоПолномуПути

Описание, пример вызова

// Проходит полный путь к реквизиту объекта через точки и устанавливает его в новое значение.
//
// Возвращает:
//  Неопределено - если не получилось найти реквизит.
//  ПроизвольноеЗначение - значение найднного реквизита.
//
Процедура УстановитьЗнчениеРеквизитаПоПолномуПути(Знач Объект, ПолныйПутьКРеквизиту, НовоеЗначение) Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.УстановитьЗнчениеРеквизитаПоПолномуПути(Объект, ПолныйПутьКРеквизиту, НовоеЗначение)

ПолучитьЗнчениеРеквизитаПоПолномуПути

Описание, пример вызова

// Проходит полный путь к реквизиту объекта через точки и возвращает его значение.
//
// Возвращает:
//  Неопределено - если не получилось найти реквизит.
//  ПроизвольноеЗначение - значение найднного реквизита.
//
Функция ПолучитьЗнчениеРеквизитаПоПолномуПути(Знач Объект, ПолныйПутьКРеквизиту) Экспорт

Пример вызова

Результат = ОбщегоНазначенияКлиентУХ.ПолучитьЗнчениеРеквизитаПоПолномуПути(Объект, ПолныйПутьКРеквизиту)

ПолучитьРеквизитПоПолномуПути

Описание, пример вызова

// Проходит полный путь к реквизиту объекта через точки и возвращает пару
// (Предпоследний объект в цепочке, Имя реквизита в предпоследнем объекте).
//
// Параметры:
//  Объект - любой объект 1С позволяющий обратиться к значению через [].
//  ПолныйПутьКРеквизиту - Строка, путь к реквизиту начиная но не включая Объект. Например, "НоменклатураПоставщиков.Поставщик".
//    Может включать "." (обращение к реквизиту реквизита) и "[]" (обращение к строке табличной части объекта по индексу строки).
//
// Возвращает:
//  Неопределено - если не получилось найти реквизит.
//  Структура:
//    Объект - объект содержащий реквизит.
//    ИмяРеквизита - имя реквизита для доступа в Объекте.
//
Функция ПолучитьРеквизитПоПолномуПути(Знач Объект, ПолныйПутьКРеквизиту) Экспорт

Пример вызова

Результат = ОбщегоНазначенияКлиентУХ.ПолучитьРеквизитПоПолномуПути(Объект, ПолныйПутьКРеквизиту)

ПередНачаломРаботыСистемы

Описание, пример вызова

Процедура ПередНачаломРаботыСистемы() Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.ПередНачаломРаботыСистемы()

ПриНачалеРаботыСистемы

Описание, пример вызова

// Выполняется при старте системы.
Процедура ПриНачалеРаботыСистемы() Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.ПриНачалеРаботыСистемы()

ВключитьНапоминания

Описание, пример вызова

// Запускает периодическую проверку напоминаний
Процедура ВключитьНапоминания() Экспорт

Пример вызова

ОбщегоНазначенияКлиентУХ.ВключитьНапоминания()

ПоискПервойПодстроки

Описание, пример вызова

// Функция ищет вхождение в переданную строку значений из списка значений
//
// Параметры
//  Строка - исходная строка для поиска
//  ПодстрокиПоиска - список значений с коллекцией подстрок для поиска
//  СтрокаПоиска - элемент, в который возвращается найденное значение строки подпоиска
//
// Возвращаемое значение:
//  Наименьшая позиция найденного значения
//
Функция ПоискПервойПодстроки(Строка,ПодстрокиПоиска,СтрокаПоиска) Экспорт

Пример вызова

Результат = ОбщегоНазначенияКлиентУХ.ПоискПервойПодстроки(Строка, ПодстрокиПоиска, СтрокаПоиска));

ВернутьТекстПисьмаВФорматеHTML

Описание, пример вызова

// Функция возвращает по переданному тексту строку
// в формате HTML с выделенными ссылками на ресурсы www
//
// Параметры
//  ТекстПисьма - текстовая строка
//
// Возвращаемое значение:
//  Текст в формате HTML
//
Функция ВернутьТекстПисьмаВФорматеHTML(ТекстПисьма) Экспорт

Пример вызова

Результат = ОбщегоНазначенияКлиентУХ.ВернутьТекстПисьмаВФорматеHTML(ТекстПисьма)