IPicture::SelectPicture-Methode (ocidl.h)

  • Artikel

Wählt ein Bitmapbild in einem bestimmten Gerätekontext aus und gibt den Gerätekontext, in dem das Bild zuvor ausgewählt wurde, sowie das GDI-Handle des Bilds zurück. Diese Methode funktioniert in Verbindung mit IPicture::get_CurDC.

Syntax

HRESULT SelectPicture(
  [in]  HDC        hDCIn,
  [out] HDC        *phDCOut,
  [out] OLE_HANDLE *phBmpOut
);

Parameter

[in] hDCIn

Ein Handle für den Gerätekontext, in dem das Bild ausgewählt werden soll.

[out] phDCOut

Ein Zeiger auf eine Variable, die den vorherigen Gerätekontext empfängt. Dieser Parameter kann NULL sein, wenn der Aufrufer diese Informationen nicht benötigt. Der Besitzer des Gerätekontexts liegt immer in der Verantwortung des Aufrufers.

[out] phBmpOut

Ein Zeiger auf eine Variable, die das GDI-Handle des Bilds empfängt. Dieser Parameter kann NULL sein, wenn der Aufrufer das Handle nicht benötigt. Der Besitz dieses Handles wird durch den fOwn-Parameter bestimmt, der an OleCreatePictureIndirect übergeben wird. Bilder, die aus einem Stream geladen werden, besitzen immer ihre Ressourcen.

Rückgabewert

Diese Methode unterstützt die Standardrückgabewerte E_FAIL, E_INVALIDARG, E_OUTOFMEMORY und S_OK.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

Ipicture

IPicture::get_CurDC