SendGDIPlusImage Property


ReportListener.SendGDIPlusImage Property [= iExpr]

Целочисленный тип данных.

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

Перечисленный ниже список значений для iExpr распознается базовым классом ReportListener.

0 или любое отрицательное целое число: (0 используется по умолчанию) Базовый класс ReportListener не предоставляет дескриптор для картинок GDI+ наследуемым классам в методе Render.

1 и большие целочисленные значения: Базовый класс ReportListener предоставляет дескриптор для картинок GDI+ наследуемым классам в методе Render.

Применяется к: Объект ReportListener.

Значение этого свойства не имеет смыслового значения для объектов базового класса ReportListener; оно не оказывает влиятия на обычную печать или возможности предпросмотра визуализации. Однако, ReportListeners при предоставлении других типов вывода может установить это свойство в 1 и получить дескриптор графического объекта, представляющего собой визуализированную картинку, которая доставляется из поля General или из свойства PictureVal элемента управления Image, а не из источников на основе файлов.

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

Совет
Когда у вас имеется ссылка на дескриптор GDI+ графики, вы используете GDI+ API для управления им. Visual FoxPro поставляется с рядом фундаментальных классов, разработанных для облегчения использования GDI+ API. Для получения более подробной информации смотрите их описания в Фундаментальные классы GDI Plus API Wrapper.

Совет

Когда у вас имеется ссылка на дескриптор GDI+ графики, вы используете GDI+ API для управления им. Visual FoxPro поставляется с рядом фундаментальных классов, разработанных для облегчения использования GDI+ API. Для получения более подробной информации смотрите их описания в Фундаментальные классы GDI Plus API Wrapper.

Значение этого свойства не оказывает влияния на обработку объектом ReportListener картинок, на основе файлов. Наследуемые классы получают соответветствующее имя файла в качестве параметра метода Render, поэтому и не требуется других дескрипторов.

Приведенный ниже фрагмент кода, показывающий три метода ReportListener, схож со внутренними методами наследуемого класса XMLDisplayListener. Смотрите описание Фундаментальный класс ReportListener XML Display-Style для получения более подробной информации об этом классе и обработки им картинок.

В событии BeforeReport, код этого примера сохраняет текущее значение SendGDIPlusImage. Затем он проверяет, содержит ли отчет какие-либо поля General. Если он находит любые ссылки на картинки в информации раскладки отчета, он устанавливает SendGDIPlusImage в 1 для использования на протяжении исполнения отчета.

	Скопировать код
#DEFINE LISTENER_SEND_GDI_IMAGE_HANDLE 1 PROCEDURE BeforeReport() THIS.oldSendGDIPlusImage = THIS.SendGDIPlusImage IF (THIS.SendGDIPlusImage < LISTENER_SEND_GDI_IMAGE_HANDLE) ; AND THIS.checkReportForGeneralFields() THIS.SendGDIPlusImage = LISTENER_SEND_GDI_IMAGE_HANDLE ENDIF DODEFAULT() ENDPROC PROCEDURE checkReportForGeneralFields() LOCAL liGeneralFields, llOpened THIS.SetFRXDataSession() IF USED("FRX") * проверка,так как метод может быть вызван в LoadReport() наравне с BeforeReport() SELECT FRX ELSE USE (THIS.CommandClauses.File) SHARED NOUPDATE ALIAS FRX IN 0 SELECT FRX llOpened = .T. ENDIF COUNT FOR ObjType = FRX_OBJTYP_PICTURE AND ; Offset = FRX_PICTURE_SOURCE_GENERAL TO ; liGeneralFields IF llOpened USE IN FRX ENDIF THIS.SetCurrentDataSession() RETURN ( liGeneralFields > 0 ) ENDPROC PROCEDURE AfterReport() DODEFAULT() THIS.SendGDIPlusImage = THIS.oldSendGDIPlusImage ENDPROC

Скопировать код

#DEFINE LISTENER_SEND_GDI_IMAGE_HANDLE 1
PROCEDURE BeforeReport()
   THIS.oldSendGDIPlusImage = THIS.SendGDIPlusImage     
   IF (THIS.SendGDIPlusImage < LISTENER_SEND_GDI_IMAGE_HANDLE) ;
        AND THIS.checkReportForGeneralFields() 
     THIS.SendGDIPlusImage =   LISTENER_SEND_GDI_IMAGE_HANDLE
   ENDIF    
   DODEFAULT()
ENDPROC

PROCEDURE checkReportForGeneralFields()
   LOCAL liGeneralFields, llOpened
   THIS.SetFRXDataSession()
   IF USED("FRX") 
      * проверка,так как метод может быть вызван в LoadReport() наравне  с BeforeReport()
      SELECT FRX
   ELSE
      USE (THIS.CommandClauses.File) SHARED NOUPDATE ALIAS FRX IN 0
      SELECT FRX
      llOpened = .T.
   ENDIF   
   COUNT FOR ObjType = FRX_OBJTYP_PICTURE  AND  ;
            Offset =  FRX_PICTURE_SOURCE_GENERAL TO ;
            liGeneralFields
   IF llOpened
      USE IN FRX         
   ENDIF
   THIS.SetCurrentDataSession()
   RETURN ( liGeneralFields > 0 )
ENDPROC

PROCEDURE AfterReport()
   DODEFAULT()
   THIS.SendGDIPlusImage = THIS.oldSendGDIPlusImage
ENDPROC

Возвращаемое значение

Замечания

Пример

Смотрите также

Задачи

Справочное руководство

Прочие ресурсы