Struttura GdiplusStartupInput (gdiplusinit.h)

Articolo
03/09/2023

La struttura GdiplusStartupInput contiene un blocco di argomenti richiesti dalla funzione GdiplusStartup .

Sintassi

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

Members

GdiplusVersion

Tipo: UINT32

Specifica la versione di GDI+. Deve essere 1.

DebugEventCallback

Tipo: DebugEventProc

Puntatore a una funzione di callback che GDI+ può chiamare, nelle build di debug, per asserzioni e avvisi. Il valore predefinito è NULL.

SuppressBackgroundThread

Tipo: BOOL

Valore booleano che specifica se eliminare il thread di sfondo GDI+. Se si imposta questo membro su TRUE, GdiplusStartup restituisce (nel relativo parametro di output ) un puntatore a una funzione hook e un puntatore a una funzione di unhook. È necessario chiamare tali funzioni in modo appropriato per sostituire il thread in background. Se non si vuole essere responsabili della chiamata alle funzioni hook e unhook, impostare questo membro su FALSE. Il valore predefinito è FALSE.

SuppressExternalCodecs

Tipo: BOOL

Valore booleano che specifica se si vuole che GDI+ elimina i codec di immagine esterni. GDI+ versione 1.0 non supporta codec di immagine esterni, quindi questo campo viene ignorato. Il valore predefinito è FALSE.

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

Costruttore per la struttura GdiplusStartupInput .

Il costruttore imposta il membro GdiplusVersion su 1. Tutti i parametri del costruttore sono facoltativi, quindi è possibile dichiarare una variabile di tipo GdiplusStartupInput senza passare alcun argomento al costruttore e tutti i membri verranno inizializzati con valori predefiniti appropriati.

Commenti

La struttura GdiplusStartupInput fornisce un costruttore che imposta il membro GdiplusVersion su 1 e consente di specificare i valori per gli altri tre membri. Tutti i parametri del costruttore sono facoltativi, quindi è possibile dichiarare una variabile di tipo GdiplusStartupInput senza passare alcun argomento al costruttore e tutti i membri verranno inizializzati con valori predefiniti appropriati.

Se si imposta il membro SuppressBackgroundThread su TRUE nel parametro di input di GdiplusStartup, è necessario chiamare le funzioni hook e unhook restituite nel parametro di output restituito da tale funzione. Chiamare queste funzioni prima e dopo il ciclo principale del messaggio dell'applicazione; ovvero un ciclo di messaggi attivo per la durata di GDI+. Chiamare la funzione hook prima dell'avvio del ciclo e chiamare la funzione unhook dopo la fine del ciclo.

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	gdiplusinit.h (include gdiplus.h)

Vedi anche

[GdiplusShutdown] ((windows/win32/api/gdiplusinit/nf-gdiplusinit-gdiplusshutdown)
GdiplusStartup
[GdiplusStartupOutput] ((windows/win32/api/gdiplusinit/ns-gdiplusinit-gdiplusstartupoutput)
Introduzione

Condividi tramite