Struktura ATL_DRAWINFO

Článek
06/09/2015

Obsahuje informace používané pro vykreslování na různé cíle, například tiskárnu, metasoubor nebo ovládací prvek ActiveX.

struct ATL_DRAWINFO{ 
   UINT cbSize; 
   DWORD dwDrawAspect; 
   LONG lindex; 
   DVTARGETDEVICE* ptd; 
   HDC hicTargetDev; 
   HDC hdcDraw; 
   LPCRECTL prcBounds; 
   LPCRECTL prcWBounds; 
   BOOL bOptimize; 
   BOOL bZoomed; 
   BOOL bRectInHimetric; 
   SIZEL ZoomNum; 
   SIZEL ZoomDen; 
};

Členy

cbSize
Velikost struktury v bajtech.
dwDrawAspect
Určuje, jak má být zastoupeny cíl.Připomínky můžete zahrnout obsah, ikony, miniatury nebo tištěného dokumentu.Seznam možných hodnot naleznete v tématu DVASPECT a DVASPECT2.
index
Část cíl, který má význam pro operace kreslení.Jeho výklad závisí na hodnotě v dwDrawAspect člena.
PTD
Ukazatel DVTARGETDEVICE struktury, která umožňuje optimalizaci výkresu podle stran určené.Poznámka: novější objekty a kontejnery, které podporují rozhraní optimalizované výkresu podporují také tento člen.Starší objekty a kontejnery, které nepodporují rozhraní optimalizované výkresu vždy zadat NULL tohoto člena.
hicTargetDev
Informace o kontextu pro cílové zařízení odkazuje ptd ze kterého objekt extrahujte metriky zařízení a vyzkoušet možnosti zařízení.Pokud ptd je NULL, objekt je třeba ignorovat hodnoty v hicTargetDev člena.
hdcDraw
Kontext zařízení, na který chcete nakreslit.Pro objekt bez oken hdcDraw člen MM_TEXT režimu mapování s jeho logické souřadnice odpovídající souřadnice nadřazeného okna klienta.Navíc by měla být kontext zařízení ve stejném stavu, jako je obvykle předaných WM_PAINT zprávy.
prcBounds
Ukazatel RECTL struktura určující obdélníku na hdcDraw a by měl být stanoven na objekt.Tento člen řídí umístění a roztažení objektu.Tento člen by měl být NULL kreslení windowless aktivní objekt v místě.V každé situaci NULL není platná hodnota a výsledkem by měla být E_INVALIDARG kód chyby.Pokud kontejneru předá než-NULL hodnotu windowless objektu, objekt by požadované stran vykreslit do kontextu zařízení a obdélník.Kontejner to může požádat windowless objekt pro vykreslení-aktivní, druhé zobrazení objektu nebo tisk objektu.
prcWBounds
Pokud hdcDraw je kontext zařízení metasoubor (viz GetDeviceCaps v ), je ukazatel na RECTL struktura určující ohraničovacího rámečku v podkladovém metasoubor.Struktura obdélník obsahuje rozsah okno a okno původu.Tyto hodnoty jsou užitečné pro kreslení metasoubory.Obdélník označeny prcBounds je vnořená uvnitř tohoto prcWBounds obdélníku; jsou ve stejném prostoru souřadnic.
bOptimize
Nenulová hodnota, pokud je výkres ovládací prvek bude optimalizována, jinak 0.Pokud je optimalizována výkresu, stav kontext zařízení automaticky obnoven po dokončení vykreslení.
bZoomed
Nenulová hodnota, pokud má cílový faktor zvětšení, jinak 0.Faktor zvětšení je uložen v ZoomNum.
bRectInHimetric
Pokud nenulová rozměry prcBounds v HIMETRIC, jinak 0.
ZoomNum
Šířka a Výška obdélníku, do kterého je objekt vykreslen.Faktor zvětšení podél osy x (podíl fyzická velikost objektu jeho aktuální míry) cíle je hodnota ZoomNum.cx dělená hodnotou ZoomDen.cx.Podobným způsobem je dosaženo lupy podél osy y.
ZoomDen
Skutečná šířka a výška cíle.

Poznámky

Typické využití této struktury by načítání informací během vykreslování cílového objektu.Je například načíst hodnoty z ATL_DRAWINFO uvnitř vaší přetížení CComControlBase::OnDrawAdvanced.

Tato struktura ukládá informace použité k vykreslení vzhled objektu pro cílové zařízení.Poskytnuté informace lze ve výkresu na obrazovku, tiskárnu nebo dokonce metasoubor.