IDesktopWallpaper::GetBackgroundColor-Methode (shobjidl_core.h)

Artikel
08/26/2023

Ruft die Farbe ab, die auf dem Desktop sichtbar ist, wenn kein Bild angezeigt wird oder wenn der Desktophintergrund deaktiviert wurde. Diese Farbe wird auch als Rahmen verwendet, wenn das Desktophintergrundbild nicht den gesamten Bildschirm füllt.

Syntax

HRESULT GetBackgroundColor(
  [out] COLORREF *color
);

Parameter

[out] color

Ein Zeiger auf einen COLORREF-Wert , der bei erfolgreicher Rückgabe dieser Methode den RGB-Farbwert empfängt. Wenn bei dieser Methode ein Fehler auftritt, wird dieser Wert auf 0 festgelegt.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Weitere Informationen

IDesktopWallpaper

IDesktopWallpaper::SetBackgroundColor

Share via