Funzione OleDraw (ole2.h)

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.

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

Vedi anche

IViewObject::D raw