Поделиться через

Структура GdiplusStartupInput (gdiplusinit.h)

  • Статья

Структура GdiplusStartupInput содержит блок аргументов, необходимых для функции GdiplusStartup .

Синтаксис

struct GdiplusStartupInput {
  UINT32         GdiplusVersion;
  DebugEventProc DebugEventCallback;
  BOOL           SuppressBackgroundThread;
  BOOL           SuppressExternalCodecs;
  void           GdiplusStartupInput(
    DebugEventProc debugEventCallback,
    BOOL           suppressBackgroundThread,
    BOOL           suppressExternalCodecs
  );
};

Члены

GdiplusVersion

Тип: UINT32

Указывает версию GDI+. Должен иметь значение 1.

DebugEventCallback

Тип: DebugEventProc

Указатель на функцию обратного вызова, которую GDI+ может вызывать в отладочных сборках для утверждений и предупреждений. Значение по умолчанию — NULL.

SuppressBackgroundThread

Тип: BOOL

Логическое значение, указывающее, следует ли подавлять фоновый поток GDI+. Если для этого элемента задано значение TRUE, то GdiplusStartup возвращает (в своем выходном параметре) указатель на функцию-перехватчик и указатель на функцию отмены перехватчика. Эти функции необходимо вызвать соответствующим образом, чтобы заменить фоновый поток. Если вы не хотите нести ответственность за вызов функций перехватчика и отмены перехватчика, задайте для этого элемента значение FALSE. Значение по умолчанию — FALSE.

SuppressExternalCodecs

Тип: BOOL

Логическое значение, указывающее, следует ли подавлять внешние кодеки изображений в GDI+. GDI+ версии 1.0 не поддерживает внешние кодеки изображений, поэтому это поле игнорируется. Значение по умолчанию — FALSE.

void GdiplusStartupInput( DebugEventProc debugEventCallback, BOOL suppressBackgroundThread, BOOL suppressExternalCodecs)

Конструктор для структуры GdiplusStartupInput .

Конструктор устанавливает для элемента GdiplusVersion значение 1. Все параметры конструктора являются необязательными, поэтому можно объявить переменную типа GdiplusStartupInput , не передавая аргументы конструктору, и все элементы будут инициализированы соответствующими значениями по умолчанию.

Комментарии

Структура GdiplusStartupInput предоставляет конструктор, который задает для элемента GdiplusVersion значение 1 и позволяет указать значения для трех других элементов. Все параметры конструктора являются необязательными, поэтому можно объявить переменную типа GdiplusStartupInput , не передавая аргументы конструктору, и все элементы будут инициализированы соответствующими значениями по умолчанию.

Если для элемента SuppressBackgroundThread задано значение TRUE во входном параметре GdiplusStartup, необходимо вызвать функции перехватчика и отмены перехвата, возвращаемые в выходном параметре, возвращаемом этой функцией. Вызовите эти функции до и после цикла сообщений main приложения, т. е. цикл сообщений, который активен в течение всего времени существования GDI+. Вызовите функцию перехватчика перед началом цикла и вызовите функцию unhook после завершения цикла.

Требования

   
Минимальная версия клиента Windows XP, Windows 2000 Профессиональная [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть gdiplusinit.h (включая gdiplus.h)

См. также раздел

  • [GdiplusShutdown] ((windows/win32/api/gdiplusinit/nf-gdiplusinit-gdiplusshutdown)
  • GdiplusStartup
  • [GdiplusStartupOutput] ((windows/win32/api/gdiplusinit/ns-gdiplusinit-gdiplusstartupoutput)
  • Начало работы