Возвращает или задает объект «область».
Синтаксис:
<ИмяОбласти> |
Идентификатор области секции, как она задана в конфигураторе. |
Описание:
В процессе конфигурирования для секции можно задавать практически неограниченное число дополнительно выделенных и поименованных областей для выделения любой необходимой информации.
Атрибут <ИмяОбласти> позволяет обращаться к поименованной области секции. Для обращения к конкретной области секции следует указать ее идентификатор, заданный для этой области в конфигураторе.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
Секция = Таб.ПолучитьСекцию("ЗаголовокОтчета");
Секция.Заглавие.Текст = "Товарный отчет";
Таб.ВывестиСекцию(Секция);
Возращает Область секции.
Синтаксис 1:
Область(<Адрес>)
Синтаксис 2:
Область(<R1>, <С1>, <R2>, <С2 >)
Англоязычный синоним:
Area
Параметры:
<Адрес> |
Необязательный параметр. Строковое выражение, задающее либо имя области, заданное в конфигураторе, либо адрес в формате «R1C1:R2C2». |
<Rl> |
Необязательный параметр. Числовое выражение. Номер первой строки области. |
<С1> |
Необязательный параметр. Числовое выражение. Номер первого столбца области. |
<R2> |
Необязательный параметр. Числовое выражение. Номер последней строки области. |
<С2> |
Необязательный параметр. Числовое выражение. Номер последнего столбца области. |
Возвращаемое значение:
Значение типа «ОбластьТаблицы».
Описание:
Функция Область возвращает значение области секции. При задании адреса области, номера строк и столбцов задаются относительно начала данной секции. Если последняя строка и последний столбец отсутствуют, то область задана единственной ячейкой. Если строки или столбцы отсутсвуют, то область задана диапазоном столбцов или строк соответственно. Если метод вызван без параметров, то область задана всей секцией.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
Секция = Таб.ПолучитьСекцию("ЗаголовокОтчета");
ВыбОбласть = Секция.Область("Заглавие");
ВыбОбласть.Текст = "Товарный отчет";
Таб.ВывестиСекцию(Секция);
Прочитать/установить значение текста области.
Синтаксис:
Текст
Англоязычный синоним:
Text
Описание:
Атрибут Текст позволяет прочитать\установить значение текста области (аналогично тому, как в конфигураторе интерактивно задают значение формулы в свойствах ячейки талины «Свойства»- закладка «Текст»).
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R1C1");
ВыбОбласть.Текст = "Товарный отчет";
Установить расшифровку области.
Синтаксис:
Расшифровка(<Значение>, <ФлагДляВсейСтроки>)
Англоязычный синоним:
Details
Параметры:
<Значение> |
Значение расшифровки области. |
<ФлагДляВсейСтроки> |
Необязательный параметр. Число: 0 — обычный режим; 1 — установить данную расшифровку для всей строки; 2 — не вызывать расшифровку для данной ячейки. Значение по умолчанию — 0. |
Описание:
Метод Расшифровка записывает расшифровку области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Расшифровка(ВыбДокумент, 1);
Объединить ячейки области.
Синтаксис:
Объединить()
Англоязычный синоним:
Merge
Описание:
Метод Объединить объединяет ячейки области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R1C1:R8C4");
ВыбОбласть.Объединить();
Получить/установить шрифт области.
Синтаксис:
Шрифт(<ИмяШрифта>)
Англоязычный синоним:
Font
Параметры:
<ИмяШрифта> |
Необязательный параметр. Строковое выражение, задающее имя шрифта или «имя, набор символов», где основные наборы символов: 204 — русский; 238 — европейский; 186 — балтийский; 161 — греческий; 162 — турецкий. Если параметр опущен, то шрифт области не изменяется. |
Возвращаемое значение:
Имя шрифта до исполнения метода.
Описание:
Метод Шрифт устанавливает шрифт области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial, 204");
Получить/установить размер шрифта области.
Синтаксис:
РазмерШрифта(<Размер>)
Англоязычный синоним:
FontSize
Параметры:
<Размер> |
Необязательный параметр. Числовое выражение, задающее размер шрифта. Если параметр опущен, то размер шрифта области не изменяется. |
Возвращаемое значение:
Размер шрифта до исполнения метода.
Описание:
Метод РазмерШрифта устанавливает размер шрифта области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
Получить/установить признак жирного шрифта области.
Синтаксис:
Полужирный(<Жирный>)
Англоязычный синоним:
Bold
Параметры:
<Жирный> |
Необязательный параметр. Число: 1 — жирный шрифт; 0 — не жирный шрифт. Если параметр опущен, то жирность шрифта области не изменяется. |
Возвращаемое значение:
Признак жирного шрифта до исполнения метода.
Описание:
Метод Полужирный устанавливает признак жирного шрифта области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Полужирный(1);
Получить/установить признак шрифта курсив области.
Синтаксис:
Курсив(<Курсив>)
Англоязычный синоним:
Italic
Параметры:
<Курсив> |
Необязательный параметр. Число: 1 — шрифт курсив; 0 — шрифт не курсив. Если параметр опущен, то признак курсив шрифта области не изменяется. |
Возвращаемое значение:
Признак шрифта курсив до исполнения метода.
Описание:
Метод Курсив устанавливает признак шрифта курсив области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl__l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Курсив(1);
Получить/установить признак подчеркнутого шрифта области.
Синтаксис:
Подчеркнутый(<Подчеркнутый>)
Англоязычный синоним:
Underline
Параметры:
<Подчеркнутый> |
Необязательный параметр. Число: 1 — шрифт подчеркнутый; 0 — шрифт не подчеркнутый. Если параметр опущен, то признак подчеркнутого шрифта области не изменяется. |
Возвращаемое значение:
Признак подчеркнутого шрифта до исполнения метода.
Описание:
Метод Подчеркнутый устанавливает признак подчеркнутого шрифта области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
Получить/установить признак вертикального выравнивания текста области.
Синтаксис:
ВертикальноеПоложение(<Положение>)
Англоязычный синоним:
VerticalAlign
Параметры:
<Положение> |
Необязательный параметр. Число: 1 — сверху; 2 — снизу; 3 — по центру. Если параметр опущен, то признак вертикального выравнивания текста области не изменяется. |
Возвращаемое значение:
Признак вертикального выравнивания текста до исполнения метода.
Описание:
Метод ВертикальноеПоложение устанавливает признак вертикального выравнивания текста области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВкбОбласть.Подчеркнутый(1);
ВыбОбласть.ВертикальноеПоложение(3);
Получить/установить признак горизонтального выравнивания текста области.
Синтаксис:
ГоризонтальноеПоложение(<Положение>)
Англоязычный синоним:
HorizontalAlign
Параметры:
<Положение> |
Необязательный параметр. Число: 1 — слева; 2 — справа; 3 — по центру; 4 — по ширине. (5 – 8) — по выделенным столбцам: слева/справа/по центру/по ширине. Если параметр опущен, то признак горизонтального выравнивания текста области не изменяется. |
Возвращаемое значение:
Признак горизонтального выравнивания текста до исполнения метода.
Описание:
Метод ГоризонтальноеПоложение устанавливает признак горизонтального выравнивания текста области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть(" tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
Получить/установить признак контроля текста области.
Синтаксис:
Контроль(<Контроль>)
Англоязычный синоним:
Control
Параметры:
<Контроль> |
Необязательный параметр. Число: 1 — Авто; 2 — Обрезать; 3 — Забивать; 4 — Переносить; 5 — Красный; 6 — Забивать+Красный. Если параметр опущен, то признак контроля текста области не изменяется. |
Возвращаемое значение:
Признак контроля текста до исполнения метода.
Описание:
Метод Контроль устанавливает признак контроля текста области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
Получить/установить рамку сверху области.
Синтаксис:
РамкаСверху(<Рамка>)
Англоязычный синоним:
TopBorder
Параметры:
<Рамка> |
Необязательный параметр. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если параметр опущен, то рамка сверху области не изменяется. |
Возвращаемое значение:
Рамка сверху до исполнения метода.
Описание:
Метод РамкаС верху устанавливает рамку сверху области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.РамкаСверху(3);
Получить/установить рамку снизу области.
Синтаксис:
РамкаСнизу(<Рамка>)
Англоязычный синоним:
BottomBorder
Параметры:
<Рамка> |
Необязательный параметр. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если параметр опущен, то рамка снизу области не изменяется. |
Возвращаемое значение:
Рамка снизу до исполнения метода.
Описание:
Метод РамкаСнизу устанавливает рамку снизу области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.РамкаСнизу(3 );
Получить/установить рамку слева области.
Синтаксис:
РамкаСлева(<Рамка>)
Англоязычный синоним:
LeftBorder
Параметры:
<Рамка> |
Необязательный параметр. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если параметр опущен, то рамка слева области не изменяется. |
Возвращаемое значение:
Рамка слева до исполнения метода.
Описание:
Метод РамкаСлева устанавливает рамку слева области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.РамкаСлева(3);
Получить/установить рамку справа области.
Синтаксис:
РамкаСправа(<Рамка>)
Англоязычный синоним:
RightBorder
Параметры:
<Рамка> |
Необязательный параметр. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если параметр опущен, то рамка справа области не изменяется. |
Возвращаемое значение:
Рамка справа до исполнения метода.
Описание:
Метод РамкаСправа устанавливает рамку справа области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.РамкаСправа(3);
Установить рамки всех ячеек области.
Синтаксис:
Рамка(<РамкаСлева>, <РамкаСверху>, <РамкаСправа>, <РамкаСнизу>)
Англоязычный синоним:
Border
Параметры:
<РамкаСлева> |
Необязательные параметры. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если какой либо параметр опущен, то соответствующая рамка ячеек области не изменяется. |
Описание:
Метод Рамка устанавливает рамки всех ячеек области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10 );
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.Рамка(0, 3, 3, 3);
Установить рамки по краям области.
Синтаксис:
РамкаОбвести(<Рамка Слева>, <РамкаСверху>, <РамкаСправа>, <РамкаСнизу>)
днглоязычный синоним:
BorderOutline
Параметры:
<РамкаСлева> |
Необязательные параметры. Число: 0 — нет; 1 — очень тонкая; 2 — тонкая точечная; 3 — тонкая сплошная; 4 — средняя сплошная; 5 — толстая сплошная; 6 — двойная; 7 — тонкая средний пунктир; 8 — тонкая длинный пунктир; 9 — толстая пунктир. Если какой либо параметр опущен, то соответствующая рамка ячеек области не изменяется. |
Описание:
Метод РамкаОбвести устанавливает рамки по краям области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.РамкаОбвести(0, 3, 3, 3);
Получить/установить режим отображения цвета фона области.
Синтаксис 1:
ЦзетФона(<Цвет>)
Синтаксис 2:
ЦветФона(<R>, <G>, <B>)
Англоязычный синоним:
BackgroundColor
Параметры:
<Цвет> |
Необязательный параметр. Числовое выражение, значение которого задает RGB цвет. Допустимые значения от 0 до 16777'215. Значение -1 (минус единица) задает цвет, заданный для всей области по умолчанию. |
<R> |
Числовое выражение, значение которого задает красную компоненту цвета. Допустимые значения от 0 до 256. |
<G> |
Числовое выражение, значение которого задает зеленую компоненту цвета. Допустимые значения от 0 до 256. |
<B> |
Числовое выражение, значение которого задает синюю компоненту цвета. Допустимые значения от 0 до 256. |
Возвращаемое значение:
Текущее числовое значение RGB-цвета фона области (на момент до исполнения метода).
Описание:
Метод ЦветФона позволяет установить режим отображения цвета фона области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.ЦветФона(34, 126, 211);
Получить/установить режим отображения цвета рамки области.
Синтаксис 1:
ЦветРамки(<Цвет>)
Синтаксис 2:
ЦветРамки(<R>, <G>, <В>)
Англоязычный синоним:
BorderColor
Параметры:
<Цвет> |
Необязательный параметр. Числовое выражение, значение которого задает RGB цвет. Допустимые значения от 0 до 16777'215. Значение -1 (минус единица) задает цвет, заданный для всей области по умолчанию. |
<R> |
Числовое выражение, значение которого задает красную компоненту цвета. Допустимые значения от 0 до 256. |
<G> |
Числовое выражение, значение которого задает зеленую компоненту цвета. Допустимые значения от 0 до 256. |
<B> |
Числовое выражение, значение которого задает синюю компоненту цвета. Допустимые значения от 0 до 256. |
Возвращаемое значение:
Текущее числовое значение RGB-цвета рамки области (на момент до исполнения метода).
Описание:
Метод ЦветРамки позволяет установить режим отображения цвета рамки области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.ЦветРамки(34, 126, 211);
Получить/установить режим отображения цвета текста области.
Синтаксис 1:
ЦветТекста(<Цвет>}
Синтаксис 2:
ЦветТекста(<R>, <G>, <В>)
Англоязычный синоним:
TextColor
Параметры:
<Цвет> |
Необязательный параметр. Числовое выражение, значение которого задает RGB цвет. Допустимые значения от 0 до 16777'215. Значение -1 (минус единица) задает цвет, заданный для всей области по умолчанию. |
<R> |
Числовое выражение, значение которого задает красную компоненту цвета. Допустимые значения от 0 до 256. |
<G> |
Числовое выражение, значение которого задает зеленую компоненту цвета. Допустимые значения от 0 до 256. |
<B> |
Числовое выражение, значение которого задает синюю компоненту цвета. Допустимые значения от 0 до 256. |
Возвращаемое значение:
Текущее числовое значение RGB-цвета текста области (на момент до исполнения метода).
Описание:
Метод ЦветТекста позволяет установить режим отображения цвета текста области.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.ЦветТекста(34, 126, 211);
Получить/установить высоту строк, проходящих через область.
Синтаксис:
ВысотаСтроки(<Высота>)
Англоязычный синоним:
RowHeight
Параметры:
<Высота> Необязательный параметр. Число: высота строк, проходящих через область в пунктах с точностью до 0,25. Если параметр опущен, то высота строк области не изменяется.
Возвращаемое значение:
Высота строк области в пунктах области (на момент до исполнения метода).
Описание:
Метод ВысотаСтроки устанавливает высоту строк, проходящих через область.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.ВысотаСтроки(3 );
Получить/установить ширину столбцов, проходящих через область.
Синтаксис:
ШиринаСтолбца(<Ширина>)
Англоязычный синоним:
ColumnWidth
Параметры:
<Ширина> |
Необязательный параметр. Число: ширина столбцов, проходящих через область в стандартных символах с точностью до 0, 125. Если параметр опущен, то ширина столбцов области не изменяется. |
Возвращаемое значение:
Ширина столбцов области в стандартных символах (на момент до исполнения метода).
Описание:
Метод ШиринаСтолбца устанавливает ширину столбцов, проходящих через область.
Пример:
Таб = СоздатьОбъект("Таблица");
Таб.Открыть("tabl_l.mxl");
ВыбОбласть = Таб.Область("R8C4");
ВыбОбласть.Шрифт("Arial");
ВыбОбласть.РазмерШрифта(10);
ВыбОбласть.Подчеркнутый(1);
ВыбОбласть.ГоризонтальноеПоложение(3);
ВыбОбласть.Контроль(4);
ВыбОбласть.ШиринаСтолбца(13);
При работе с таблицей в режиме ввода данных не могут использоваться методы и атрибуты, предназначенные для заполнения таблицы в обычном режиме, например, методы вывода секций, метод Показать и другие, не имеющие смысла для табличного документа в режиме ввода данных. Разумеется, могут использоваться методы управляющие параметрами печати табличного документа, а также собственно метод Напечатать.
В данном разделе приводятся специфические атрибуты и методы, используемые для работы с табличным документом в режиме ввода данных.
Предоставляет доступ к именованной области таблицы в режиме ввода данных.
Синтаксис:
<ИмяОбласти> |
Имя области таблицы в режиме ввода данных. |
Описание:
В процессе конфигурирования для таблицы в режиме ввода данных можно задавать практически неограниченное число поименованных областей.
Атрибут <имяОбласти> позволяет обращаться к поименованной области таблицы. Для обращения к конкретной области следует указать ее имя, заданное для этой области в конфигураторе.
Пример:
Таблица.Заглавие.Текст = "Товарный отчет";
Активизировать область таблицы.
Синтаксис:
АктивнаяОбласть(<Адрес>)
Англоязычный синоним:
ActiveArea
Параметры:
<Адрес> |
Необязательный параметр. Строковое выражение, задающее имя области или адрес в формате «R1C1:R2C2». |
Возвращаемое значение:
Строковое значение имени активной области или адрес в формате «R1C1:R2C2» до начала выполнения метода.
Описание:
Функция АктивнаяОбласть активизирует область таблицы.
Пример:
Таблица.АктивнаяОбласть("tabl_l");
Выгружает значения и имена для всех предназначенных для ввода ячеек в объект типа «Список значений».
Синтаксис:
Выгрузить(<СписокЗначений>)
Англоязычный синоним:
Load
Параметры:
<СписокЗначений> |
Идентификатор объекта типа «Список значений», куда выгружаются парами значения и имена для всех предназначенных для ввода ячеек. |
Описание:
Метод Выгрузить выгружает значения и имена для всех предназначенных для ввода ячеек таблицы в объект типа «Список значений», причем имя ячейки становится представлением а данные из ячейки — значением в записи списка значений.
Пример:
Список = СоздатьОбъект("СписокЗначений");
Таблица.Выгрузить(Список);
Загружает значения и имена для всех предназначенных для ввода ячеек из объекта типа «Список значений».
Синтаксис:
Загрузить(<СписокЗначений>)
Англоязычный синоним:
Save
Параметры:
<СписокЗначений> Идентификатор объекта типа «Список значений», откуда загружаются парами значения и имена для всех предназначенных для ввода ячеек.
Описание:
Метод Загрузить загружает значения и имена для всех предназначенных для ввода ячеек таблицы из объекта типа «Список значений», причем представление списка значений становится именем ячейки, а значение записи становится значением ячейки.
Пример:
Процедура ОчиститьТаблицу()
Список = СоздатьОбъект("СписокЗначений");
Таблица.Выгрузить(Список);
ИмяЯчейки = "";
Для Н = 1 По Список.РазмерСписка() Цикл
ЗначЯчейки = Список.ПолучитьЗначение(Н, ИмяЯчейки);
Список.УстановитьЗначение(Н, 0, ИмяЯчейки, 1);
КонецЦикла;
Таблица.Загрузить(Список);
КонецПроцедуры;
При работе с областью таблицы в режиме ввода данных не может использоваться метод Расшифровка, а также метод Объединить.
В данном разделе приводятся специфические атрибуты и методы, используемые для работы с областью таблицы в режиме ввода данных.
Арибут, предоставляет доступ к значению, записанному в области.
Синтаксис:
Значение
Англоязычный синоним:
Value
Описание:
Атрибут Значение позволяет прочитать\установить значение, записанное в области (аналогично тому, как в конфигураторе интерактивно задают значение в свойствах ячейки талины «Свойства»- закладка «Данные»).
Пример:
ВыбОбласть = Таблица.Область("R1C1");
ВыбОбласть.Значение = '01.09.98';
Устанавливает формат для вывода всех выражений в ячейках области таблицы.
Синтаксис:
Формат(<СтрокаФормата>)
Англоязычный синоним:
Format
Параметры:
<СтрокаФормата> |
Необязательный параметр. Строковое выражение, содержащее форматную строку (см. Формат). |
Возвращаемое значение:
Строковое значение, содержащее текущую форматную строку по умолчанию для области таблицы (на момент до исполнения метода).
Описание:
Метод Формат устанавливает формат для вывода всех выражений выводимых в ячейках области таблицы.
Пример:
ВыбОбласть.Формат("415.2");
Установить тип для значения ячейки неопределенного вида.
Синтаксис:
УстановитьТип(<Выражение>)
Англоязычный синоним:
AssignType
Параметры:
<Выражение> |
Выражение. Тип значения этого выражения будет присвоен значению ячейки. |
Описание:
Метод УстановитьТип позволяет установить тип для значения ячейки, которому в конфигураторе назначен тип «Неопределенный».
Пример:
ВыбОбласть.УстановитьТип(Товар);
См. также: НазначитьТип, ТипЗначения, ТипЗначенияСтр
Назначить тип для значения ячейки неопределенного вида.
Синтаксис:
НазначитьТип(<ИмяТипа>, <Длина>, <Точность>)
Англоязычный синоним:
SetType
Параметры:
<ИмяТипа> |
Строковое выражение — название типа данных, которое назначается значению ячейки. Например: "Строка", "Число", "Справочник.Товары", " Документ.РасходнаяНакладная" и т. п. |
<Длина> |
Необязательный параметр. Числовое выражение — длина поля представления данных. Имеет смысл только при задании числового или строкового типа. |
<Точность> |
Необязательный параметр. Числовое выражение — число знаков числа после десятичной точки. Имеет смысл только при задании числового типа. |
Описание:
Метод НазначитьТип позволяет назначить тип для значения ячейки, которому в конфигураторе назначен тип «Неопределенный».
Пример:
ВыбОбласть.НазначитьТип("Число", 15, 2);
См. также: УстановитьТип, ТипЗначения, ТипЗначенияСтр
Установка режима редактирования.
Синтаксис:
Доступность(<Режим>)
Англоязычный синоним:
Enable
Параметры:
<Режим> |
Необязательный параметр. Числовое выражение: 1 — разрешено редактирование элемента формы; 0 — запрещено редактирование. |
Возвращаемое значение:
Текущее числовое значение режима редактирования области таблицы (на момент до исполнения метода).
Описание:
Метод Доступность позволяет установить режим редактирования выбранной области таблицы.
Пример:
ВыбОбласть.Доступность(0);
Определяет возможность редактирования значения области таблицы.
Синтаксис:
Редактирование(<Флаг>)
Англоязычный синоним:
EnableEdit
Параметры:
<Флаг> |
Число: 1 — значения ячеек области таблицы редактируются как обычно; 0 — значения не редактируется но могут выбираться кнопкой выбора. Отличие от метода Доступность в том, что Доступность отключает и кнопку выбора. |
Описание:
Метод Редактирование определяет возможность редактирования значения непосредственно в ячейках области таблицы для полей ввода типа «Число», «Строка», «Дата», «Счет».
Пример:
ВыбОбласть.Редактирование(1);
Предопределенная процедура обработки ячейки таблицы.
Описание:
ОбработкаЯчейкиТаблицы(<Значение>, <ФлагСтандартнойОбработки> , <КонтекстТаблицы>,
<Адрес>)
Англоязычный синоним:
SheetCellProcessing
Параметры:
<Значение> |
Здесь в процедуру передается вычисленное значение ячейки (задается в конфигураторе: «Свойства» ячейки, «Текст», «Значение»). |
<ФлагСтандартнойОбработки> |
Флаг, установка которого в теле процедуры в 1 приведет к выполнению стандартной обработки значения ячейки (открытию документа, элемента справочника и т. п.). |
<КонтекстТаблицы> |
Необязательный параметр. Имя переменной, куда система передаст контекст всей таблицы (см. Передача контекста в качестве параметра). С помощью значения этого контекста можно произвольно манипулировать данной таблицей пока она открыта, например, вывести туда дополнительные секции или очистить и заполнить всю таблицу заново. Пока данный объект «Таблица» существует, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0. |
<Адрес> |
Необязательный параметр. Имя переменной, куда система передаст адрес ячейки/объекта в формате «R1C1:R2C2». |
Описание:
Вызов процедуры ОбработкаЯчейкиТаблицы на исполнение производится в системе 1С:Предприятие по двойному щелчку мыши или по нажатию клавиши «Enter» в табличном документе на выбранной ячейке
Замечание ОбработкаЯчейкиТаблицы — предопределенная процедура. Она не является встроенной процедурой языка. Для нее определено только название и синтаксис. Тело процедуры должно быть написано пользователем, осуществляющим конфигурирование, в программном модуле формы, из которой сформирован табличный документ или в глобальном модуле.
Замечание Объект типа «СписокЗначений» может записываться в поле «значение» ячейки таблицы и использоваться затем процедурой ОбработкаЯчейкиТаблицы.
Важно! Если процедура описана в модуле формы, то вызывается она, иначе система запускает одноименную процедуру из глобального модуля.
Внимание! Данная предопределенная процедура не вызывается при выборе ячейки таблицы в режиме ввода данных. Для этого случая вызывается предопределенная процедура ПриВыбореЯчейкиТаблицы.
Пример:
Процедура ОбработкаЯчейкиТаблицы(ЗначениеЯчейки, Флаг)
// Тело процедуры
//. . .
КонецПроцедуры
Предопределенная процедура обработки ячейки таблицы в режиме ввода данных.
Описание:
ПриВыбореЯчейкиТаблицы(<ИмяИлиАдрес>, <Значение>)
Англоязычный синоним:
OnSelectSheetCell
Параметры:
<ИмяИлиАдрес> |
Здесь в процедуру системой передается строковое значение имени области таблицы, если выбранная ячейка помечена в таблице как отдельная область, или адрес ячейки в формате «R1C1:R2C2». |
<Значение> |
Здесь в процедуру системой передается значение даной ячейки, а если диаграмма — значение выбранного элемента. |
Описание:
Вызов процедуры ПриВыбореЯчейкиТаблицы на исполнение производится в системе 1С:Предприятие по двойному щелчку мыши или по нажатию клавиши «Enter» на выбранной ячейке в таблице
Внимание! Данная предопределенная процедура вызывается в модуле формы при выборе ячейки только для таблиц в режиме ввода данных.
Замечание ПриВыбореЯчейкиТаблицы — предопределенная процедура. Она не является встроенной процедурой языка. Для нее определено только название и синтаксис. Тело процедуры должно быть написано пользователем, осуществляющим конфигурирование, в программном модуле формы, в которой используется таблица в режиме ввода данных.
Пример:
Процедура ПриВыбореЯчейкиТаблицы(ИмяЯчейки, Знач)
// Тело процедуры
// ...
КонецПроцедуры