WALLPAPEROPT-Struktur (shlobj_core.h)

Enthält die Anzeigeoptionen für das Hintergrundbild. Wird mit Mitgliedern der IActiveDesktop-Schnittstelle verwendet.

Syntax

typedef struct _tagWALLPAPEROPT {
  DWORD dwSize;
  DWORD dwStyle;
} WALLPAPEROPT;

Member

dwSize

Art: DWORD

Die Größe dieser WALLPAPEROPT-Struktur .

dwStyle

Art: DWORD

Der Hintergrundbildstil; einer der folgenden Werte:

WPSTYLE_CENTER (0x0)

0x0. Zentrieren Sie das Hintergrundbild in seiner ursprünglichen Größe, und füllen Sie den verbleibenden Bereich mit einer volltonigen Hintergrundfarbe, wenn das Bild kleiner als der Bildschirm ist, oder zuschneiden Sie das Bild, wenn das Bild größer ist.

WPSTYLE_TILE (0x1)

0x1. Kacheln Sie das Hintergrundbild, beginnend in der oberen linken Ecke des Bildschirms. Dabei wird das Bild in seiner Originalgröße verwendet.

WPSTYLE_STRETCH (0x2)

0x2. Strecken Sie das Bild, um den Vollbildmodus abzudecken. Dies kann zu einer Verzerrung des Bilds führen, da das Seitenverhältnis des Bilds nicht beibehalten wird.

WPSTYLE_KEEPASPECT (0x3)

0x3. In Windows 7 eingeführt. Vergrößern oder verkleinern Sie das Bild, um den Bildschirm zu füllen, wobei das Seitenverhältnis des ursprünglichen Bilds beibehalten wird. Bei Bedarf wird das Bild entweder oben und unten oder rechts und links mit der Hintergrundfarbe aufgefüllt, um alle Bildschirmbereiche zu füllen, die nicht vom Bild abgedeckt sind.

WPSTYLE_CROPTOFIT (0x4)

0x4. In Windows 7 eingeführt. Vergrößern oder verkleinern Sie das Bild, um den Bildschirm zu füllen, wobei das Seitenverhältnis des ursprünglichen Bilds beibehalten wird. Bei Bedarf wird das Bild entweder oben und unten oder links und rechts zugeschnitten, um dem Bildschirm anzupassen.

WPSTYLE_SPAN (0x5)

0x5. In Windows 8 eingeführt. Überspannt das Hintergrundbild auf mehreren Monitoren.

WPSTYLE_MAX

Der maximale legitime Wert dieser Flags, die zu Validierungszwecken verwendet werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP, Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	shlobj_core.h (shlobj.h einschließen)