Объекты Report и Engine - История изменений

Sidminik: /* Применение методов */

2026-10-20T03:53:06Z

Применение методов

← Предыдущая версия		Версия от 03:53, 20 октября 2026
Строка 197:		Строка 197:
	Для работы с закладками используются методы <code>AddBookmark</code> и <code>GetBookmarkPage</code> объекта <code>Engine</code>. Обычно закладки добавляются автоматически при использовании свойства <code>Bookmark</code>, которое имеется у всех объектов отчета.		Для работы с закладками используются методы <code>AddBookmark</code> и <code>GetBookmarkPage</code> объекта <code>Engine</code>. Обычно закладки добавляются автоматически при использовании свойства <code>Bookmark</code>, которое имеется у всех объектов отчета.

	Используя метод AddBookmark, можно добавлять закладку программно. Этот метод создаст закладку на текущей странице, в текущей позиции печати.		Используя метод <code>AddBookmark</code>, можно добавлять закладку программно. Этот метод создаст закладку на текущей странице, в текущей позиции печати.

	Метод GetBookmarkPage возвращает номер страницы, на которой расположена закладка. Этот метод часто применяется при создании оглавлений, для отображении номеров страниц. В этом случае отчет должен быть двухпроходным.		Метод <code>GetBookmarkPage</code> возвращает номер страницы, на которой расположена закладка. Этот метод часто применяется при создании оглавлений, для отображении номеров страниц. В этом случае отчет должен быть двухпроходным.

Sidminik: /* Применение методов */

2026-10-20T03:52:11Z

Применение методов

← Предыдущая версия		Версия от 03:52, 20 октября 2026
Строка 147:		Строка 147:
	===Применение методов===		===Применение методов===

	Используя методы <code>AddOutline</code>, <code>OutlineRoot</code> и <code>OutlineUp<code>, можно формировать структуру отчета программным способом. Обычно это делается автоматически с помощью свойства <code>OutlineExpression</code>, которое имеется у каждого бэнда и у страницы отчета.		Используя методы <code>AddOutline</code>, <code>OutlineRoot</code> и <code>OutlineUp</code>, можно формировать структуру отчета программным способом. Обычно это делается автоматически с помощью свойства <code>OutlineExpression</code>, которое имеется у каждого бэнда и у страницы отчета.

	Метод <code>AddOutline</code> добавляет к текущему узлу структуры дочерний узел и делает его текущим. С элементом ассоциируется текущая страница отчета и текущая позиция на странице. Таким образом, если несколько раз подряд вызвать <code>AddOutline</code>, то получится "лесенка" типа		Метод <code>AddOutline</code> добавляет к текущему узлу структуры дочерний узел и делает его текущим. С элементом ассоциируется текущая страница отчета и текущая позиция на странице. Таким образом, если несколько раз подряд вызвать <code>AddOutline</code>, то получится "лесенка" типа

Sidminik: /* Список методов */

2026-10-20T03:51:17Z

Список методов

← Предыдущая версия		Версия от 03:51, 20 октября 2026
Строка 145:		Строка 145:
	\|}		\|}

	Используя методы AddOutline, OutlineRoot и OutlineUp, можно формировать структуру отчета программным способом. Обычно это делается автоматически с помощью свойства OutlineExpression, которое имеется у каждого бэнда и у страницы отчета.		===Применение методов===

	Метод AddOutline добавляет к текущему узлу структуры дочерний узел и делает его текущим. С элементом ассоциируется текущая страница отчета и текущая позиция на странице. Таким образом, если несколько раз подряд вызвать AddOutline, то получится "лесенка" типа		Используя методы <code>AddOutline</code>, <code>OutlineRoot</code> и <code>OutlineUp<code>, можно формировать структуру отчета программным способом. Обычно это делается автоматически с помощью свойства <code>OutlineExpression</code>, которое имеется у каждого бэнда и у страницы отчета.

			Метод <code>AddOutline</code> добавляет к текущему узлу структуры дочерний узел и делает его текущим. С элементом ассоциируется текущая страница отчета и текущая позиция на странице. Таким образом, если несколько раз подряд вызвать <code>AddOutline</code>, то получится "лесенка" типа

	<syntaxhighlight lang="C#">		<syntaxhighlight lang="C#">
Строка 155:		Строка 157:
	</syntaxhighlight>		</syntaxhighlight>

	Для управления текущим элементом служат методы OutlineUp и OutlineRoot. Первый метод перемещает указатель на элемент, расположенный уровнем выше. Так, скрипт		Для управления текущим элементом служат методы <code>OutlineUp</code> и <code>OutlineRoot</code>. Первый метод перемещает указатель на элемент, расположенный уровнем выше. Так, скрипт

	<syntaxhighlight lang="C#">		<syntaxhighlight lang="C#">
Строка 174:		Строка 176:
	</syntaxhighlight>		</syntaxhighlight>

	Метод OutlineRoot передвигает текущий элемент в корень структуры. Например, скрипт:		Метод <code>OutlineRoot</code> передвигает текущий элемент в корень структуры. Например, скрипт:

	<syntaxhighlight lang="C#">		<syntaxhighlight lang="C#">
Строка 193:		Строка 195:
	</syntaxhighlight>		</syntaxhighlight>

	Для работы с закладками используются методы AddBookmark и GetBookmarkPage объекта Engine. Обычно закладки добавляются автоматически при использовании свойства Bookmark, которое имеется у всех объектов отчета.		Для работы с закладками используются методы <code>AddBookmark</code> и <code>GetBookmarkPage</code> объекта <code>Engine</code>. Обычно закладки добавляются автоматически при использовании свойства <code>Bookmark</code>, которое имеется у всех объектов отчета.

	Используя метод AddBookmark, можно добавлять закладку программно. Этот метод создаст закладку на текущей странице, в текущей позиции печати.		Используя метод AddBookmark, можно добавлять закладку программно. Этот метод создаст закладку на текущей странице, в текущей позиции печати.

	Метод GetBookmarkPage возвращает номер страницы, на которой расположена закладка. Этот метод часто применяется при создании оглавлений, для отображении номеров страниц. В этом случае отчет должен быть двухпроходным.		Метод GetBookmarkPage возвращает номер страницы, на которой расположена закладка. Этот метод часто применяется при создании оглавлений, для отображении номеров страниц. В этом случае отчет должен быть двухпроходным.

Sidminik: /* Список методов */

2026-10-20T03:49:01Z

Список методов

← Предыдущая версия		Версия от 03:49, 20 октября 2026
Строка 144:		Строка 144:
	\|-		\|-
	\|}		\|}

			Используя методы AddOutline, OutlineRoot и OutlineUp, можно формировать структуру отчета программным способом. Обычно это делается автоматически с помощью свойства OutlineExpression, которое имеется у каждого бэнда и у страницы отчета.

			Метод AddOutline добавляет к текущему узлу структуры дочерний узел и делает его текущим. С элементом ассоциируется текущая страница отчета и текущая позиция на странице. Таким образом, если несколько раз подряд вызвать AddOutline, то получится "лесенка" типа

			<syntaxhighlight lang="C#">
			Item1
			Item2
			Item3
			</syntaxhighlight>

			Для управления текущим элементом служат методы OutlineUp и OutlineRoot. Первый метод перемещает указатель на элемент, расположенный уровнем выше. Так, скрипт

			<syntaxhighlight lang="C#">
			Engine.AddOutline("Item1");
			Engine.AddOutline("Item2");
			Engine.AddOutline("Item3");
			Engine.OutlineUp();
			Engine.AddOutline("Item4");
			</syntaxhighlight>

			построит структуру вида

			<syntaxhighlight lang="C#">
			Item1
			Item2
			Item3
			Item4
			</syntaxhighlight>

			Метод OutlineRoot передвигает текущий элемент в корень структуры. Например, скрипт:

			<syntaxhighlight lang="C#">
			Engine.AddOutline("Item1");
			Engine.AddOutline("Item2");
			Engine.AddOutline("Item3");
			Engine.OutlineRoot();
			Engine.AddOutline("Item4");
			</syntaxhighlight>

			построит структуру следующего вида:

			<syntaxhighlight lang="C#">
			Item1
			Item2
			Item3
			Item4
			</syntaxhighlight>

			Для работы с закладками используются методы AddBookmark и GetBookmarkPage объекта Engine. Обычно закладки добавляются автоматически при использовании свойства Bookmark, которое имеется у всех объектов отчета.

			Используя метод AddBookmark, можно добавлять закладку программно. Этот метод создаст закладку на текущей странице, в текущей позиции печати.

			Метод GetBookmarkPage возвращает номер страницы, на которой расположена закладка. Этот метод часто применяется при создании оглавлений, для отображении номеров страниц. В этом случае отчет должен быть двухпроходным.

Sidminik: /* Формирование страниц готового отчета */

2026-10-20T03:46:42Z

Формирование страниц готового отчета

← Предыдущая версия		Версия от 03:46, 20 октября 2026
Строка 116:		Строка 116:
	#При работе со свойствами, которые возвращают размер, нужно учесть, что в дизайнере используются единицы измерения - ''экранные пиксели''.		#При работе со свойствами, которые возвращают размер, нужно учесть, что в дизайнере используются единицы измерения - ''экранные пиксели''.
	</div>		</div>

			===Список методов===

			{\|class="wikitable" style="margin:auto; background-color: #fff;"
			\|-
			!Метод
			!Описание
			\|-
			\|'''<code>void AddOutline(string text)</code>'''
			\|Добавляет элемент в структуру отчета и смещает текущую позицию на добавленный элемент.
			\|-
			\|'''<code>void OutlineRoot()</code>'''
			\|Смещает текущую позицию на корень структуры.
			\|-
			\|'''<code>void OutlineUp()</code>'''
			\|Смещает текущую позицию на уровень выше.
			\|-
			\|'''<code>void AddBookmark(string name)</code>'''
			\|Добавляет закладку.
			\|-
			\|'''<code>int GetBookmarkPage(string name)</code>'''
			\|Возвращает номер страницы, на которой расположена закладка с указанным именем.
			\|-
			\|'''<code>void StartNewPage()</code>'''
			\|Добавляет в отчет разрыв страницы.
			Если отчет многоколоночный, добавляется новая колонка.
			\|-
			\|}

Sidminik: /* Формирование страниц готового отчета */

2026-10-20T03:43:59Z

Формирование страниц готового отчета

← Предыдущая версия		Версия от 03:43, 20 октября 2026
Строка 110:		Строка 110:
	*Вывод очередного бэнда начинается с текущей позиции, которая определяется координатами по оси <code>X</code> и <code>Y</code>. Эта позиция возвращается в свойствах <code>Engine.CurX</code>, <code>Engine.CurY</code>. После печати очередного бэнда позиция <code>CurY</code> автоматически увеличивается на высоту напечатанного бэнда. После формирования новой страницы позиция <code>CurY = 0</code>. Позиция <code>CurX</code> изменяется при печати многоколоночных отчетов.		*Вывод очередного бэнда начинается с текущей позиции, которая определяется координатами по оси <code>X</code> и <code>Y</code>. Эта позиция возвращается в свойствах <code>Engine.CurX</code>, <code>Engine.CurY</code>. После печати очередного бэнда позиция <code>CurY</code> автоматически увеличивается на высоту напечатанного бэнда. После формирования новой страницы позиция <code>CurY = 0</code>. Позиция <code>CurX</code> изменяется при печати многоколоночных отчетов.

	'''~~''Примечание~~:''' cвойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи (то есть можно смещать бэнды вручную, используя одно из подходящих событий).		<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
			'''Примечания:'''

	~~<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">~~
	~~'''Примечание'''~~
	#Свойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи (то есть можно смещать бэнды вручную, используя одно из подходящих событий).		#Свойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи (то есть можно смещать бэнды вручную, используя одно из подходящих событий).
	#При работе со свойствами, которые возвращают размер, нужно учесть, что в дизайнере используются единицы измерения - ''экранные пиксели''.		#При работе со свойствами, которые возвращают размер, нужно учесть, что в дизайнере используются единицы измерения - ''экранные пиксели''.
	</div>		</div>

Sidminik: /* Формирование страниц готового отчета */

2026-10-20T03:43:34Z

Формирование страниц готового отчета

← Предыдущая версия		Версия от 03:43, 20 октября 2026
Строка 111:		Строка 111:

	'''''Примечание:''' cвойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи (то есть можно смещать бэнды вручную, используя одно из подходящих событий).		'''''Примечание:''' cвойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи (то есть можно смещать бэнды вручную, используя одно из подходящих событий).

			<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
			'''Примечание'''
			#Свойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи (то есть можно смещать бэнды вручную, используя одно из подходящих событий).
			#При работе со свойствами, которые возвращают размер, нужно учесть, что в дизайнере используются единицы измерения - ''экранные пиксели''.
			</div>

Sidminik: /* Формирование страниц готового отчета */

2026-10-20T03:41:59Z

Формирование страниц готового отчета

← Предыдущая версия		Версия от 03:41, 20 октября 2026
Строка 110:		Строка 110:
	*Вывод очередного бэнда начинается с текущей позиции, которая определяется координатами по оси <code>X</code> и <code>Y</code>. Эта позиция возвращается в свойствах <code>Engine.CurX</code>, <code>Engine.CurY</code>. После печати очередного бэнда позиция <code>CurY</code> автоматически увеличивается на высоту напечатанного бэнда. После формирования новой страницы позиция <code>CurY = 0</code>. Позиция <code>CurX</code> изменяется при печати многоколоночных отчетов.		*Вывод очередного бэнда начинается с текущей позиции, которая определяется координатами по оси <code>X</code> и <code>Y</code>. Эта позиция возвращается в свойствах <code>Engine.CurX</code>, <code>Engine.CurY</code>. После печати очередного бэнда позиция <code>CurY</code> автоматически увеличивается на высоту напечатанного бэнда. После формирования новой страницы позиция <code>CurY = 0</code>. Позиция <code>CurX</code> изменяется при печати многоколоночных отчетов.

	'''''Примечание:''' ~~Свойства~~ <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи~~. Это значит, что~~ можно смещать бэнды вручную, используя одно из подходящих событий. ~~Пример использования этих свойств смотрите в разделе <code>Примеры</code>.''~~		'''''Примечание:''' cвойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи (то есть можно смещать бэнды вручную, используя одно из подходящих событий).

Sidminik: /* Свойства объекта */

2026-10-20T03:41:17Z

Свойства объекта

← Предыдущая версия		Версия от 03:41, 20 октября 2026
Строка 104:		Строка 104:
	*Свойство <code>Engine.FreeSpace</code> определяет высоту свободного места на странице. Если на странице есть бэнд <code>Подвал страницы</code> его высота учитывается при вычислении <code>FreeSpace</code>. Следует учесть, что после вывода очередного бэнда свободное место на странице уменьшается, что учитывается при вычислении <code>FreeSpace</code>.		*Свойство <code>Engine.FreeSpace</code> определяет высоту свободного места на странице. Если на странице есть бэнд <code>Подвал страницы</code> его высота учитывается при вычислении <code>FreeSpace</code>. Следует учесть, что после вывода очередного бэнда свободное место на странице уменьшается, что учитывается при вычислении <code>FreeSpace</code>.

	~~Как происходит формирование~~ страниц готового отчета? Ядро ~~FastReport~~ выводит бэнды на страницу до тех пор, пока на ней остается свободное место, достаточное для вывода бэнда. Когда свободного места не остается, печатается бэнд <code>Подвал страницы</code> (если он есть) и формируется новая пустая страница. ~~Как уже говорилось, после~~ вывода очередного бэнда высота свободного места уменьшается. ~~Кроме того, вывод~~ очередного бэнда начинается с текущей позиции, которая определяется координатами по оси <code>X</code> и <code>Y</code>. Эта позиция возвращается в свойствах <code>Engine.CurX</code>, <code>Engine.CurY</code>. После печати очередного бэнда позиция <code>CurY</code> автоматически увеличивается на высоту напечатанного бэнда. После формирования новой страницы позиция <code>CurY = 0</code>. Позиция <code>CurX</code> изменяется при печати многоколоночных отчетов.		===Формирование страниц готового отчета===
			*Ядро дизайнера выводит бэнды на страницу до тех пор, пока на ней остается свободное место, достаточное для вывода бэнда.
			*Когда свободного места не остается, печатается бэнд <code>Подвал страницы</code> (если он есть) и формируется новая пустая страница.
			*После вывода очередного бэнда высота свободного места уменьшается.
			*Вывод очередного бэнда начинается с текущей позиции, которая определяется координатами по оси <code>X</code> и <code>Y</code>. Эта позиция возвращается в свойствах <code>Engine.CurX</code>, <code>Engine.CurY</code>. После печати очередного бэнда позиция <code>CurY</code> автоматически увеличивается на высоту напечатанного бэнда. После формирования новой страницы позиция <code>CurY = 0</code>. Позиция <code>CurX</code> изменяется при печати многоколоночных отчетов.

	*Свойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи. Это значит, что можно смещать бэнды вручную, используя одно из подходящих событий. Пример использования этих свойств смотрите в разделе <code>Примеры</code>.		'''''Примечание:''' Свойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи. Это значит, что можно смещать бэнды вручную, используя одно из подходящих событий. Пример использования этих свойств смотрите в разделе <code>Примеры</code>.''

Sidminik: /* Свойства объекта */

2026-10-20T03:38:28Z

Свойства объекта

← Предыдущая версия		Версия от 03:38, 20 октября 2026
Строка 100:		Строка 100:
	[[Файл: engine_obj_1.png \| center \| border]]		[[Файл: engine_obj_1.png \| center \| border]]

	Свойства Engine.PageWidth и Engine.PageHeight определяют размер области печати, которая почти всегда меньше физических размеров страницы. Размер области печати определяют поля страницы, которые задаются свойствами страницы отчета LeftMargin, TopMargin, RightMargin, BottomMargin.		*Свойства <code>Engine.PageWidth</code> и <code>Engine.PageHeight</code> определяют размер области печати, которая почти всегда меньше физических размеров страницы.
			*Размер области печати определяют поля страницы, которые задаются свойствами страницы отчета <code>LeftMargin</code>, <code>TopMargin</code>, <code>RightMargin</code>, <code>BottomMargin</code>.
			*Свойство <code>Engine.FreeSpace</code> определяет высоту свободного места на странице. Если на странице есть бэнд <code>Подвал страницы</code> его высота учитывается при вычислении <code>FreeSpace</code>. Следует учесть, что после вывода очередного бэнда свободное место на странице уменьшается, что учитывается при вычислении <code>FreeSpace</code>.

	~~Свойство Engine~~.~~FreeSpace определяет высоту~~ свободного места ~~на странице. Если на странице есть~~ бэнд "Подвал страницы~~", его высота учитывается при вычислении FreeSpace~~. ~~Следует учесть~~, ~~что~~ после вывода очередного бэнда ~~свободное место на странице~~ уменьшается, ~~что учитывается~~ при ~~вычислении FreeSpace~~.		Как происходит формирование страниц готового отчета? Ядро FastReport выводит бэнды на страницу до тех пор, пока на ней остается свободное место, достаточное для вывода бэнда. Когда свободного места не остается, печатается бэнд <code>Подвал страницы</code> (если он есть) и формируется новая пустая страница. Как уже говорилось, после вывода очередного бэнда высота свободного места уменьшается. Кроме того, вывод очередного бэнда начинается с текущей позиции, которая определяется координатами по оси <code>X</code> и <code>Y</code>. Эта позиция возвращается в свойствах <code>Engine.CurX</code>, <code>Engine.CurY</code>. После печати очередного бэнда позиция <code>CurY</code> автоматически увеличивается на высоту напечатанного бэнда. После формирования новой страницы позиция <code>CurY = 0</code>. Позиция <code>CurX</code> изменяется при печати многоколоночных отчетов.

	Как происходит формирование страниц готового отчета? Ядро FastReport выводит бэнды на страницу до тех пор, пока на ней остается свободное место, достаточное для вывода бэнда. Когда свободного места не остается, печатается бэнд "Подвал страницы" (если он есть) и формируется новая пустая страница. Как уже говорилось, после вывода очередного бэнда высота свободного места уменьшается. Кроме того, вывод очередного бэнда начинается с текущей позиции, которая определяется координатами по оси X и Y. Эта позиция возвращается в свойствах Engine.CurX, Engine.CurY. После печати очередного бэнда позиция CurY автоматически увеличивается на высоту напечатанного бэнда. После формирования новой страницы позиция CurY = 0. Позиция CurX изменяется при печати многоколоночных отчетов.		*Свойства <code>Engine.CurX</code> и <code>Engine.CurY</code> доступны не только для чтения, но и для записи. Это значит, что можно смещать бэнды вручную, используя одно из подходящих событий. Пример использования этих свойств смотрите в разделе <code>Примеры</code>.

	Свойства Engine.CurX и Engine.CurY доступны не только для чтения, но и для записи. Это значит, что можно смещать бэнды вручную, используя одно из подходящих событий. Пример использования этих свойств смотрите в разделе "Примеры".