IPicture::Render-Methode (ocidl.h)

Artikel
02/29/2024

Rendert (zeichnet) einen angegebenen Teil des Bilds, der durch den Offset (xSrc,ySrc) des Quellbilds und die zu kopierenden Dimensionen (cxSrc,xySrc) definiert ist. Dieses Bild wird im angegebenen Gerätekontext gerendert, am Punkt (x,y) positioniert und auf die Dimensionen (cx, cy) skaliert. Der prcWBounds-Parameter gibt die Position dieses Renderings an, wenn der Zielgerätekontext selbst eine Metadatei ist. Solche Informationen sind erforderlich, um eine Metadatei in einer anderen zu platzieren. Weitere Informationen finden Sie im PrcWBounds-Parameter von IViewObject2::D raw.

Syntax

HRESULT Render(
  [in] HDC                hDC,
  [in] LONG               x,
  [in] LONG               y,
  [in] LONG               cx,
  [in] LONG               cy,
  [in] OLE_XPOS_HIMETRIC  xSrc,
  [in] OLE_YPOS_HIMETRIC  ySrc,
  [in] OLE_XSIZE_HIMETRIC cxSrc,
  [in] OLE_YSIZE_HIMETRIC cySrc,
  [in] LPCRECT            pRcWBounds
);

Parameter

[in] hDC

Ein Handle des Gerätekontexts, auf dem das Bild gerendert werden soll.

[in] x

Die horizontale Koordinate in hdc , an der das gerenderte Bild platziert werden soll.

[in] y

Die vertikale Koordinate in hdc , an der das gerenderte Bild platziert werden soll.

[in] cx

Die horizontale Dimension (Breite) des Zielrechtecks.

[in] cy

Die vertikale Dimension (Höhe) des Zielrechtecks

[in] xSrc

Der horizontale Offset im Quellbild, von dem aus mit dem Kopieren begonnen werden soll.

[in] ySrc

Der vertikale Offset im Quellbild, von dem aus mit dem Kopieren begonnen werden soll.

[in] cxSrc

Die horizontale Ausdehnung, die aus dem Quellbild kopiert werden soll.

[in] cySrc

Die vertikale Ausdehnung, die aus dem Quellbild kopiert werden soll.

[in] pRcWBounds

Ein Zeiger auf ein Rechteck, das die Position des Ziels in einem Metadateigerätekontext enthält, wenn hdc ein Metadatei-DC ist. In solchen Fällen kann nicht NULL sein.

Rückgabewert

Diese Methode unterstützt die Standardrückgabewerte E_FAIL, E_INVALIDARG und E_OUTOFMEMORY sowie Folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Das Bild wurde erfolgreich gerendert.
E_POINTER	Die Adresse in prcWBounds ist ungültig, wenn hdc einen Metadateigerätekontext enthält.
CTL_E_INVALIDPROPERTYVALUE	Der Parameter cx, cy, cxSrc oder cySrc hat den Wert 0.

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

Freigeben über