ТабличныйДокумент.НаправлениеПерехода

Свойства · StepDirection

Тип: ТипНаправленияПереходаТабличногоДокумента. Определяет направление перехода при завершении редактирования ячейки таблицы.

Полное описание, параметры и ограничения

ТабличныйДокумент.НаправлениеПерехода (SpreadsheetDocument.StepDirection)

ТабличныйДокумент (SpreadsheetDocument)

НаправлениеПерехода (StepDirection)

Доступен, начиная с версии 8.0.

Использование:
Чтение и запись.
Описание:
Тип: ТипНаправленияПереходаТабличногоДокумента.
Определяет направление перехода при завершении редактирования ячейки таблицы.
Доступность:

Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.

Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация

Практические примеры

Выделить две области и поставить текущую ячейку

Выделение принадлежит показу собственного документа. Коллекция выделенных областей и ТекущаяОбласть имеют разный смысл.

Где и как запускать

Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.

Подготовка

  1. Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.

  2. На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).

  3. Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.

  4. Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.

  5. Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.

&НаКлиенте
Процедура УчебныйПример(Команда)
    ТабДок = ПостроитьУчебныйДокумент();
    ТабДок.ВыделенныеОбласти.Очистить();
    ТоварныеИмена = ТабДок.Область(3, 1, 4, 1);
    Итог = ТабДок.Область(5, 4);
    ТабДок.ВыделенныеОбласти.Добавить(ТоварныеИмена);
    ТабДок.ВыделенныеОбласти.Добавить(Итог);
    Сообщить(ТабДок.ВыделенныеОбласти.Количество() = 2);
    ИндексИтога = ТабДок.ВыделенныеОбласти.Индекс(Итог);
    Сообщить(ТабДок.ВыделенныеОбласти.Получить(ИндексИтога).Низ = 5);
    ТабДок.ВыделенныеОбласти.Удалить(ТоварныеИмена);
    ТабДок.ТекущаяОбласть = ТабДок.Область(3, 2);
    ТабДок.НаправлениеПерехода = ТипНаправленияПереходаТабличногоДокумента.ПоСтрокам;
    Сообщить(ТабДок.ВыделенныеОбласти.Количество() = 1);
    Сообщить(ТабДок.ТекущаяОбласть.Лево = 2);
    Сообщить(ТабДок.Область(5, 4).Значение = 800);
    ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры

&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
    ТабДок = УчебнаяТаблица();

    Возврат ТабДок;
КонецФункции

&НаСервереБезКонтекста
Функция УчебнаяТаблица()
    ТабДок = Новый ТабличныйДокумент;
    ТабДок.ТолькоПросмотр = Истина;
    ТабДок.ОтображатьСетку = Ложь;
    ТабДок.Область(, 1, , 1).ШиринаКолонки = 35;
    ТабДок.Область(, 2, , 2).ШиринаКолонки = 10;
    ТабДок.Область(, 3, , 3).ШиринаКолонки = 14;
    ТабДок.Область(, 4, , 4).ШиринаКолонки = 15;
    Заголовок = ТабДок.Область(1, 1, 1, 4);
    Заголовок.Объединить();
    Заголовок.Текст = "Учебная таблица — данные только в памяти";
    Заголовок.Шрифт = Новый Шрифт("Arial", 12, Истина);
    Заголовок.ЦветФона = Новый Цвет(230, 242, 255);
    Заголовок.ВысотаСтроки = 24;
    ТабДок.Область(2, 1).Текст = "Товар";
    ТабДок.Область(2, 2).Текст = "Количество";
    ТабДок.Область(2, 3).Текст = "Цена";
    ТабДок.Область(2, 4).Текст = "Сумма";
    Товары = Новый Массив;
    Товары.Добавить(Новый Структура("Название,Количество,Цена", "Книга", 3, 250));
    Товары.Добавить(Новый Структура("Название,Количество,Цена", "Ручка", 1, 50));
    НомерСтроки = 3;
    Итого = 0;
    Для Каждого Товар Из Товары Цикл
        ТабДок.Область(НомерСтроки, 1).Текст = Товар.Название;
        Значения = Новый Массив;
        Значения.Добавить(Товар.Количество);
        Значения.Добавить(Товар.Цена);
        Значения.Добавить(Товар.Количество * Товар.Цена);
        Для НомерКолонки = 2 По 4 Цикл
            Ячейка = ТабДок.Область(НомерСтроки, НомерКолонки);
            Ячейка.СодержитЗначение = Истина;
            Ячейка.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
            Ячейка.Значение = Значения.Получить(НомерКолонки - 2);
            Ячейка.Формат = "ЧДЦ=2; ЧН=0";
        КонецЦикла;
        Итого = Итого + Товар.Количество * Товар.Цена;
        НомерСтроки = НомерСтроки + 1;
    КонецЦикла;
    ПодписьИтога = ТабДок.Область(5, 1, 5, 3);
    ПодписьИтога.Объединить();
    ПодписьИтога.Текст = "Итого";
    Итог = ТабДок.Область(5, 4);
    Итог.СодержитЗначение = Истина;
    Итог.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
    Итог.Значение = Итого;
    Итог.Формат = "ЧДЦ=2; ЧН=0";
    Все = ТабДок.Область(2, 1, 5, 4);
    Все.Шрифт = Новый Шрифт("Arial", 10);
    Граница = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1, Ложь);
    Все.Обвести(Граница, Граница, Граница, Граница);
    Возврат ТабДок;
КонецФункции

Разбор по шагам

  1. Документ построен на сервере и возвращён клиенту. Изменения выделения выполняем в клиентском обработчике перед показом.

  2. В коллекцию добавляем две непересекающиеся области A3:A4 и D5. Текущая ячейка B3 задаётся отдельно.

  3. НаправлениеПерехода ПоСтрокам относится к переходу между ячейками при редактировании, а не к сортировке товаров.

  4. Удаление одной области из выделения не очищает значения в ячейках. Проверяем, что итог 800 остался.

Как проверить результат

  1. Пять клиентских проверок дают Истина.

  2. Показ содержит одну оставшуюся выделенную область D5 и текущую ячейку B3; итог не удалён.

  3. Копирование/переход зависят от режима просмотра и поведения клиента: не трактуйте выделение как защиту.

Ожидаемый результат

Управление собственным выделением с сохранением данных.

На что обратить внимание

  1. Коллекция выделений может меняться дальнейшими действиями пользователя; проверки относятся к моменту до показа.

  2. Очистить у выделенных областей снимает выделение, а не очищает табличный документ.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.