Основная страница

 

Глава 31-2
Работа с Таблицами


 

Атрибуты и методы объекта «СекцияТаблицы»

<ИмяОбласти>

Возвращает или задает объект «область».

Синтаксис:

<ИмяОбласти>

Идентификатор области секции, как она задана в конфигураторе.

Описание:

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

Атрибут <ИмяОбласти> позволяет обращаться к поименованной области секции. Для обращения к конкретной области секции следует указать ее идентификатор, заданный для этой области в конфигураторе.

Пример:

Таб = СоздатьОбъект("Таблица");

Таб.Открыть("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» на выбранной ячейке в таблице

Внимание! Данная предопределенная процедура вызывается в модуле формы при выборе ячейки только для таблиц в режиме ввода данных.

Замечание ПриВыбореЯчейкиТаблицы — предопределенная процедура. Она не является встроенной процедурой языка. Для нее определено только название и синтаксис. Тело процедуры должно быть написано пользователем, осуществляющим конфигурирование, в программном модуле формы, в которой используется таблица в режиме ввода данных.

Пример:

Процедура ПриВыбореЯчейкиТаблицы(ИмяЯчейки, Знач)

   // Тело процедуры

   // ...

КонецПроцедуры







Перейти  к оглавлению: Описание встроенного языка