Estrutura GdiplusStartupInput (gdiplusinit.h)

A estrutura GdiplusStartupInput contém um bloco de argumentos que são exigidos pela função GdiplusStartup .

Sintaxe

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

Membros

GdiplusVersion

Tipo: UINT32

Especifica a versão do GDI+. Deve ser 1.

DebugEventCallback

Tipo: DebugEventProc

Ponteiro para uma função de retorno de chamada que o GDI+ pode chamar, em builds de depuração, para declarações e avisos. O valor padrão é NULL.

SuppressBackgroundThread

Tipo: BOOL

Valor booliano que especifica se o thread em segundo plano GDI+ deve ser suprimido. Se você definir esse membro como TRUE, gdiplusStartup retornará (em seu parâmetro de saída ) um ponteiro para uma função de gancho e um ponteiro para uma função de unhook. Você deve chamar essas funções adequadamente para substituir o thread em segundo plano. Se você não quiser ser responsável por chamar as funções hook e unhook, defina esse membro como FALSE. O valor padrão é FALSE.

SuppressExternalCodecs

Tipo: BOOL

Valor booliano que especifica se você deseja que o GDI+ suprima codecs de imagem externos. O GDI+ versão 1.0 não dá suporte a codecs de imagem externos, portanto, esse campo é ignorado. O valor padrão é FALSE.

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

Construtor para a estrutura GdiplusStartupInput .

O construtor define o membro GdiplusVersion como 1. Todos os parâmetros do construtor são opcionais, portanto, você pode declarar uma variável do tipo GdiplusStartupInput sem passar argumentos para o construtor e todos os membros serão inicializados com valores padrão apropriados.

Comentários

A estrutura GdiplusStartupInput fornece um construtor que define o membro GdiplusVersion como 1 e permite que você especifique valores para os outros três membros. Todos os parâmetros do construtor são opcionais, portanto, você pode declarar uma variável do tipo GdiplusStartupInput sem passar argumentos para o construtor e todos os membros serão inicializados com valores padrão apropriados.

Se você definir o membro SuppressBackgroundThread como TRUE no parâmetro de entrada de GdiplusStartup, deverá chamar as funções hook e unhook retornadas no parâmetro de saída retornado por essa função. Chame essas funções antes e depois do loop de mensagem main do aplicativo; ou seja, um loop de mensagem que está ativo durante o tempo de vida do GDI+. Chame a função de gancho antes que o loop seja iniciado e chame a função unhook após o término do loop.

Requisitos

Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	gdiplusinit.h (inclua gdiplus.h)

Confira também

• [GdiplusShutdown] ((windows/win32/api/gdiplusinit/nf-gdiplusinit-gdiplusshutdown)
• GdiplusStartup
• [GdiplusStartupOutput] ((windows/win32/api/gdiplusinit/ns-gdiplusinit-gdiplusstartupoutput)
• Guia de Introdução