Funzione OleDraw (ole2.h)

Articolo
02/29/2024

Abilita gli oggetti di disegno più facilmente. È possibile usarlo invece di chiamare direttamente IViewObject::D raw .

Sintassi

HRESULT OleDraw(
  [in] LPUNKNOWN pUnknown,
  [in] DWORD     dwAspect,
  [in] HDC       hdcDraw,
  [in] LPCRECT   lprcBounds
);

Parametri

[in] pUnknown

Puntatore all'interfaccia IUnknown nell'oggetto di visualizzazione da disegnare.

[in] dwAspect

Come rappresenta l'oggetto. Le rappresentazioni includono contenuto, un'icona, un'anteprima o un documento stampato. I valori possibili vengono acquisiti dall'enumerazione DVASPECT .

[in] hdcDraw

Contesto del dispositivo su cui creare. Impossibile essere un contesto di dispositivo metafile.

[in] lprcBounds

Puntatore a una struttura RECT che specifica il rettangolo in cui deve essere disegnato l'oggetto. Questo parametro viene convertito in una struttura RECTL e passato a IViewObject::D raw.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Codice restituito	Descrizione
OLE_E_BLANK	Nessun dato da cui disegnare.
E_ABORT	L'operazione di disegno è stata interrotta.
VIEW_E_DRAW	Nessun dato da cui disegnare.
OLE_E_INVALIDRECT	Il rettangolo non è valido.
E_INVALIDARG	Uno o più parametri non sono validi.
E_OUTOFMEMORY	Memoria insufficiente per l'operazione.
DV_E_NOIVIEWOBJECT	L'oggetto non supporta l'interfaccia IViewObject .

Commenti

La funzione helper OleDraw chiama il metodo QueryInterface per l'oggetto specificato (pUnk), chiedendo un'interfaccia IViewObject su tale oggetto. OleDraw converte quindi la struttura RECT in una struttura RECTL e chiama IViewObject::D raw come indicato di seguito:

lpViewObj->Draw(dwAspect,-1,0,0,0,hdcDraw,&rectl,0,0,0);

Non usare questa funzione per disegnare in un metafile perché non specifica il parametro necessario per il disegno in metafile.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ole2.h (include Ole2.h)
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-3 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

IViewObject::D raw

Condividi tramite