GdiplusStartupInput-Struktur (gdiplusinit.h)

  • Artikel

Die GdiplusStartupInput-Struktur enthält einen Block von Argumenten, die für die GdiplusStartup-Funktion erforderlich sind.

Syntax

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

Members

GdiplusVersion

Typ: UINT32

Gibt die Version von GDI+ an. Muss 1 sein.

DebugEventCallback

Typ: DebugEventProc

Zeiger auf eine Rückruffunktion, die GDI+ bei Debugbuilds für Assertionen und Warnungen aufrufen kann. Der Standardwert ist NULL.

SuppressBackgroundThread

Typ: BOOL

Boolescher Wert, der angibt, ob der GDI+-Hintergrundthread unterdrückt werden soll. Wenn Sie diesen Member auf TRUE festlegen, gibt GdiplusStartup (in seinem Ausgabeparameter ) einen Zeiger auf eine Hookfunktion und einen Zeiger auf eine Unhookfunktion zurück. Sie müssen diese Funktionen entsprechend aufrufen, um den Hintergrundthread zu ersetzen. Wenn Sie nicht für den Aufruf der Hook- und Unhook-Funktionen verantwortlich sein möchten, legen Sie diesen Member auf FALSE fest. Der Standardwert ist FALSE.

SuppressExternalCodecs

Typ: BOOL

Boolescher Wert, der angibt, ob GDI+ externe Bildcodecs unterdrücken soll. GDI+ Version 1.0 unterstützt keine externen Bildcodecs, daher wird dieses Feld ignoriert. Der Standardwert ist FALSE.

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

Konstruktor für die GdiplusStartupInput-Struktur .

Der Konstruktor legt das GdiplusVersion-Element auf 1 fest. Alle Konstruktorparameter sind optional, sodass Sie eine Variable vom Typ GdiplusStartupInput deklarieren können, ohne Argumente an den Konstruktor zu übergeben, und alle Member werden mit den entsprechenden Standardwerten initialisiert.

Hinweise

Die GdiplusStartupInput-Struktur stellt einen Konstruktor bereit, der das GdiplusVersion-Element auf 1 festlegt. Außerdem können Sie Werte für die anderen drei Member angeben. Alle Konstruktorparameter sind optional, sodass Sie eine Variable vom Typ GdiplusStartupInput deklarieren können, ohne Argumente an den Konstruktor zu übergeben, und alle Member werden mit den entsprechenden Standardwerten initialisiert.

Wenn Sie das SuppressBackgroundThread-Element im Eingabeparameter von GdiplusStartup auf TRUE festlegen, müssen Sie die Hook- und Unhookfunktionen aufrufen, die im ausgabeparameter zurückgegeben von dieser Funktion zurückgegeben werden. Rufen Sie diese Funktionen vor und nach der Standard Nachrichtenschleife der Anwendung auf, d. h. eine Nachrichtenschleife, die für die Lebensdauer von GDI+ aktiv ist. Rufen Sie die Hookfunktion auf, bevor die Schleife gestartet wird, und rufen Sie die Unhookfunktion auf, nachdem die Schleife endet.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile gdiplusinit.h (include gdiplus.h)

Weitere Informationen

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