Compartir a través de

Estructura GdiplusStartupInput (gdiplusinit.h)

  • Artículo

La estructura GdiplusStartupInput contiene un bloque de argumentos requeridos por la función GdiplusStartup .

Sintaxis

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

Members

GdiplusVersion

Tipo: UINT32

Especifica la versión de GDI+. Debe ser 1.

DebugEventCallback

Tipo: DebugEventProc

Puntero a una función de devolución de llamada a la que GDI+ puede llamar, en compilaciones de depuración, para aserciones y advertencias. El valor predeterminado es NULL.

SuppressBackgroundThread

Tipo: BOOL

Valor booleano que especifica si se debe suprimir el subproceso en segundo plano de GDI+. Si establece este miembro en TRUE, GdiplusStartup devuelve (en su parámetro de salida ) un puntero a una función de enlace y un puntero a una función de unhook. Debe llamar a esas funciones adecuadamente para reemplazar el subproceso en segundo plano. Si no desea ser responsable de llamar a las funciones de enlace y desenganche, establezca este miembro en FALSE. El valor predeterminado es FALSE.

SuppressExternalCodecs

Tipo: BOOL

Valor booleano que especifica si desea que GDI+ suprima los códecs de imagen externos. La versión 1.0 de GDI+ no admite códecs de imagen externos, por lo que este campo se omite. El valor predeterminado es FALSE.

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

Constructor para la estructura GdiplusStartupInput .

El constructor establece el miembro GdiplusVersion en 1. Todos los parámetros del constructor son opcionales, por lo que puede declarar una variable de tipo GdiplusStartupInput sin pasar ningún argumento al constructor y todos los miembros se inicializarán con los valores predeterminados adecuados.

Comentarios

La estructura GdiplusStartupInput proporciona un constructor que establece el miembro GdiplusVersion en 1 y permite especificar valores para los otros tres miembros. Todos los parámetros del constructor son opcionales, por lo que puede declarar una variable de tipo GdiplusStartupInput sin pasar ningún argumento al constructor y todos los miembros se inicializarán con los valores predeterminados adecuados.

Si establece el miembro SuppressBackgroundThread en TRUE en el parámetro de entrada de GdiplusStartup, debe llamar a las funciones de enlace y deshook devueltas en el parámetro de salida devuelto por esa función. Llame a esas funciones antes y después del bucle de mensajes principal de la aplicación; es decir, un bucle de mensajes que está activo durante la vigencia de GDI+. Llame a la función de enlace antes de que se inicie el bucle y llame a la función de desenganche después de que finalice el bucle.

Requisitos

   
Cliente mínimo compatible Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado gdiplusinit.h (include gdiplus.h)

Consulte también

  • [GdiplusShutdown] ((windows/win32/api/gdiplusinit/nf-gdiplusinit-gdiplusshutdown)
  • GdiplusStartup
  • [GdiplusStartupOutput] ((windows/win32/api/gdiplusinit/ns-gdiplusinit-gdiplusstartupoutput)
  • Introducción