IShellImageData::Rotate-Methode (shimgdata.h)

  • Artikel

Dreht ein Bild in Schritten von 90 Grad.

Syntax

HRESULT Rotate(
  [in] DWORD dwAngle
);

Parameter

[in] dwAngle

Art: DWORD

Der Rotationswinkel. Es werden nur Winkel von 0, 90, 180 und 270 erkannt.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich oder ein Fehlerwert andernfalls wie folgt angegeben ist:

Rückgabecode Beschreibung
E_FAIL
 Das Bild wurde nicht decodiert, oder beim Decodierungsprozess ist ein Fehler aufgetreten. Dieser Wert wird auch zurückgegeben, wenn bestimmte interne Aufrufe von GDI+-Methoden fehlschlagen.
E_NOTVALIDFORANIMATEDIMAGE
 Das Bild ist ein animiertes Bild und kann nicht gedreht werden.
E_INVALIDARG
 Der dwAngle-Parameter ist ein anderer Wert als 0, 90, 180 oder 270.
S_FALSE
 Der dwAngle-Parameter ist 0.
E_OUTOFMEMORY
 Für die Methode stehen nicht genügend Ressourcen zur Verfügung, um eine interne Arbeitskopie des Images zu erstellen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shimgdata.h
DLL Shell32.dll