При обработке изображений, которые не являются дисковыми файлами, XmlDisplayListener всегда обеспечивает копию на диске для вашего использования. По умолчанию эти файлы размещаются в том же месте, где и ваш сгенерированный выходной файл отчета, но Вы можете установить это размещение в другую папку, используя свойство XmlDisplayListener.externalFileLocation. Папка, которую Вы назначаете для этого использования, должна существовать; в противном случае, XmlDisplayListener игнорирует инструкцию..

Совет:
При подготовке к публикации web-документов вы часто хотите установить размещение файлов изображений в выделенный каталог относительно основного выходного файла. Это хорошая идея -устанавливать размещение как relative reference, как например, ".\images." XmlDisplayListener понимает эти ссылки относительно вашего основного выходного файла.

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

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

В начале запуска отчета XmlDisplayListener проверяет есть ли поля General в Вашей структуре отчета. Если он находит сылки на поля General, он временно устанавливает .SendGDIPlusImage если необходимо и восстанавливает значение позже.

В Visual FoxPro 9 проект отчета может включать выражения, на которые ссылаются элементы контроля образом,а также главные поля и образы на диске. Если Report Engine найдет выражение, отображающее, чтообъект контроля Image ассоциирован с управлением формата образа Image, пока выполняется отчет, он использует информацию из свойства Image control's PictureVal. Дополнительную информацию, смотрите PictureVal Property.

XmlDisplayListener не может узнать , что Ваши варажения формата отчета могут означать элементы управления образом (а не косвенные ссылки на файлы образа на диске), когда оценивает Ваш FRX. По этой причине, если Вы используете выражения представляющие элементы управления образом, если нет подлей General в Вашем отчете, Вы должныустановить XmlDisplayListener.SendGDIPlusImage явно. Эта явная инструкция заставит ReportListener обеспечивать необходимой информацией образа, как она представлена в отчете. С установленным этим свойством, XmlDisplayListener обнаруживает GDPlusImage оперируя первым полученным и, если это не сделано ранее, устаналивает другой, ассоциируя атрибуты, требующие сохранение файлов на диск.

По умолчанию, XmlDisplayListener просто ссылается на любые файловые образы на диске, используя оригинальное имя файла и обеспечивая полную информацию исхлдному файлу. Тем не менее, Вы можете указать XmlDisplayListener публиковать копию Ваших образов файлов в .externalFileLocation директорию на диск, так что Вы можете переместить файлы образов с Вашим основным выходным XML файлом позже. Для того чтобы сообщитьт XmlDisplayListener о том , что Вы хотите скопировать файлы образов, используйте свойство .copyImageFilesToExternalFileLocation.

XmlDisplayListener добавляет следующие общие свойства своему родительскому классу XmlListener. XmlDisplayListener не добавляет общих методов.