Az osztályok leírása a gdi használatával

GdipImages osztály

Az osztály célja a képek feldolgozására és különböző grafikai primitívumok és szövegsorok rajzolása a GDI + használatával.

Egy osztály példány objektumának létrehozása:

Az opcionális logikai paraméter, az lGdipInit megadja a GDIPlus környezet inicializálásának szükségességét. Ha értéke "true", akkor a GDIPlus inicializálásra kerül.

InterpolationMode
Megadja az interpolációs módot. 0 és 7 közötti értékeket vehet fel.

JpegQuality
Meghatározza a minőségi értéket a kép JPEG formátumban történő mentésekor. 20 és 90 közötti értékeket vehet fel.

argB
Az RGB () függvények által visszaadott színértéket a GDIPlus által használt formátumra konvertálja.

Red. Green. kék # 8213; színkomponens értékek
Alpha # 8213; Az átlátszóság értéke (0 - 255, 0 - teljesen átlátszó, 255 - teljesen átlátszó); ha a paraméter elhagyásra kerül, akkor a 255-es értéket

ClipImage
Kivág egy meghatározott téglalap alakú területet a képből, és átmásolja egy fájlt, vagy helyettesíti az eredeti képet.

Maradt. felső # 8213; A képfájl bal felső sarkának koordinátái
Szélesség. magasság # 8213; a képtöredék szélessége és magassága
cOutputFileName # 8213; (opcionális) név és fájltípus a kép mentéséhez

Ha a cOutputFileName paraméter el van hagyva, a töredék felváltja az eredeti képképet

CreateBitmap
A megadott méretű raszter létrehozása és kitöltése a megadott színnel.

szélessége. magasság # 8213; a létrehozott raszter méretét
szín # 8213; színes raszter (az ARGB módszer által visszaadott formátumban)

CreateFont
Az adott magasság és stílus betűtípusa a neve alapján.

FontName # 8213; betűtípus neve (például Arial)
szélesség # 8213; betűmagasság (valós érték, a beállított mértékegységtől függően)
stílus # 8213; betűtípus (0 - normál, 1 - dőlt, stb.)

CreateGradientBrush
Lineáris gradiens kefét hoz létre.

PointArray # 8213; egy sor pont, amely meghatározza a gradiens ecset formáját; ha a Mode paraméter van megadva, akkor a tömb négy pontot tartalmaz, amelyek négyszögletes terület formájában határoznak az ecsetet; egyébként a PointArray két pontot tartalmaz, amelyek meghatározzák az ecset színváltozásának irányát.
WrapMode # 8213; (opcionális) értéke 0 és 3 között lehet; beállítja az ecset színtúlcsordulás hatását
mód # 8213; (opcionális) értéke 0 és 3 között lehet; Határozza meg a téglalap által meghatározott kefe színváltozásának irányát

CreateHatchBrush
Létrehoz egy ecset.

stílus # 8213; (opcionális) meghatározza a lökethenger ecsetének stílusát; értéke 0-tól 52-ig terjed. Ha a paramétert elhagyjuk, akkor a 2. stílust (ferde keltetés) alkalmazzuk.
ForeColor # 8213; (opcionális) megadja a háttérszínt az ARGB módszer által visszaadott formátumban; ha a paramétert elhagyják, fehér színt alkalmaznak
BackColor # 8213; (opcionális) határozza meg az ecset ütőszínét az ARGB módszer által visszaadott formátumban; ha a paramétert elhagyják, egy fekete kefe jön létre

CreatePen
Tollat ​​hoz létre.

szélesség # 8213; Toll vastagsága (valós érték, a beállított egységtől függően)
szín # 8213; a toll színe az ARGB módszer által visszaadott formátumban; ha a paramétert elhagyják, akkor létrehoz egy fekete tollat

CreateSolidBrush
Egyszínű ecsetet hoz létre.

szín # 8213; az ecset színe az ARGB módszer által visszaadott formátumban

CreateStringFormat
Létrehoz egy StringFormat objektumot, amely szabályozza a szöveg formázását.

lDirect # 8213; (opcionális) meghatározza a szöveg kimenet irányát (ha "igaz", a szöveg függőlegesen jelenik meg); ha a paraméter el van hagyva, a szöveg vízszintesen jelenik meg

CreateTextureBrush
Egy textúrált kefét hoz létre.

TextureFileName # 8213; A fájl neve és típusa, mint textúra
WrapMode # 8213; (opcionális) értéke 0-3; A textúrák viszonylagos elhelyezkedése abban az esetben, ha a textúra mérete kisebb, mint a rajzterület mérete

DeleteBrush
Eltávolítja az ecsetet.

DeleteFont
Eltávolítja a betűtípust.

DeletePen
Törli a tollat.

DeleteStringFormat
Eltávolítja a StringFormat objektumot. Az objektum törlése után a szöveg nem formázódik.

LezártCurve, FillClosedCurve
Zárt spline-t húz (festékeket).

PointArray # 8213; a spline pontok koordinátáinak tömbje
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

DrawCurve
Csúsztat.

PointArray # 8213; a spline pontok koordinátáinak tömbje
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

DrawEllipse, FillEllipse
Egy ellipszis (kör) húz (festékeket).

x, y # 8213; az ellipszis (kör) középső koordinátái
átmérő # 8213; vízszintes átmérő
Diameter1 # 8213; függőleges átmérő
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

DrawImage
Rajzol egy képet egy külső grafikus kimeneti eszközön vagy raszteren.

ObjGraphics # 8213; a kimeneti eszközhöz társított grafikus objektum leírója
Balra, fentre # 8213; a bal felső pont koordinátái a kép rajzolásához
Szélesség, Magasság # 8213; (opcionális) meghatározza a kép szélességét és magasságát; ha a paramétereket elhagyják, akkor az eredeti kép mérete

DrawImageFromFile
A raszteren lévő fájlból leolvassa a képet.

Fájlnév # 8213; A fájl neve és típusa, amelynek képét a kép meglévő képén fogják rajzolni
Balra, fentre # 8213; a bal felső pont koordinátái, ahonnan a kép lesz rajzolva

DrawLine
A sor elejét és végpontját a megadott koordináták szerint húzza.

x1, y1 # 8213; a kiindulási pont koordinátái
x2, y2 # 8213; végpont koordinátákat
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

DrawLines
A megszakított vonalat a koordinátapont-tömbben megadott koordináták szerint húzza.

PointArray # 8213; egy vonal pontjának koordinátái
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

DrawPie
Szektort vagy ívet rajzol.

x, y # 8213; a szektor (ív) középpontjának koordinátái
átmérő # 8213; vízszintes átmérő
Diameter1 # 8213; függőleges átmérő
StartAngle # 8213; valós érték, meghatározza a kezdeti szöget (fokban)
SweepAngle # 8213; valós érték, meghatározza az ág (ív) szögét (fokban)
ArcFlag # 8213; (opcionális) logikai; A "hazugság" meghatározza, hogy mi lesz a rajzolt szektor
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

FillPie
Festeni az ágazatot.

x, y # 8213; a szektor (ív) középpontjának koordinátái
átmérő # 8213; vízszintes átmérő
Diameter1 # 8213; függőleges átmérő
StartAngle # 8213; valós érték, meghatározza a kezdeti szöget (fokban)
SweepAngle # 8213; valós érték, meghatározza az ág (ív) szögét (fokban)
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

DrawPolygon, FillPolygon
Rajzolja ki (árnyékolja ki) a sokszöget.

PointArray # 8213; poligonpontok koordinátáinak tömbje
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

DrawRectangle, FillRectangle
Rajzol (árnyékolja ki) egy téglalapot.

Maradt. felső # 8213; a téglalap bal felső pontjának koordinátái
Szélesség. magasság # 8213; a téglalap szélessége és magassága
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

DrawRectangles, FillRectangles
Sok téglalapot húz (sötétít).

PointArray # 8213; téglalap pont koordináták
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

zsinórral
Rajzol egy szöveges szöveget a megadott téglalap alakú területen.

Maradt. felső # 8213; a négyszögletes terület bal felső pontjának koordinátái
Szélesség. magasság # 8213; a négyszögletes terület szélessége és magassága; Ha a paraméter nulla, akkor a szöveg egy sorban lesz rajzolva
TextString # 8213; rajz szöveg
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

Mielőtt felhívja a módszert, állítsa be a kívánt betűtípust a CreateFont módszerrel, és szükség esetén hívja fel a CreateStringFormat metódust, hogy meghatározza a szöveg kimeneti irányát

FillImage
Feltölti a rasztert a megadott színnel.

Az opcionális színparaméter megadja az ARGB / módszer által visszaadott formátum színét.

GetImageResolution
Visszaadja a raszter felbontását (dpi).

Paraméterek (referencia szerint):

HorDPI # 8213; valós érték; a vízszintes dpi értéket adja vissza
VertDPI # 8213; valós érték; dpi értéket vertikálisan

GetImageSize
Visszaadja a kép méretét.

A Szélesség és a Magasság paraméterek (referencia szerint átadva), a képméretek (képpontokban)

GetMeasureString
Számolja ki a karakterlánc méreteit.

húr # 8213; melynek méretét meg kell határozni
Szélesség. magasság # 8213; a téglalap alakú terület szélessége és magassága, ahol a vonal várhatóan kimeneti; referenciaként továbbítják, és helyébe a tényleges értékek lépnek
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

GetRawFormat
Meghatározza a grafikus fájlformátumot (BMP, JPEG, GIF stb.).

Állap.info
Visszaadja az állapotkódot az osztály módszerének végrehajtása után. A pozitív értékek azonosítják a GDIPlus függvények végrehajtásakor előforduló hibákat, a negatív értékek az osztályhoz hozzáadott hibakódokat jeleznek. A hibák listája az 1. és 2. táblázatban látható. Ha a módszer nulla értéket ad vissza, akkor nem volt hiba.

GraphicsFromImage
A memóriában betöltött képhez társított grafikus objektumot hoz létre.

LoadFromFile
Betölti a képet egy fájlból a memóriába.

A FileName paraméter adja meg a feltöltendő fájl nevét és elérési útját

LoadFromField
Betöl egy képet táblázatban vagy egy Visual FoxPro változóban.

ResizeImage
Megváltoztatja a kép méretét, vagy új képet ment el a fájlban, vagy kicseréli az eredeti képet.

NewWidth. NewHeight # 8213; új képméretek
OutputFileName # 8213; (opcionális) fájlnév a kép mentéséhez; ha a paraméter kihagyásra kerül, akkor az új kép a meglévőt helyettesíti

RotateFlip
A kép visszaverődését és elforgatását 90 ° -os többszöggel végzi el.

A RotateFlipCode paraméter 0-tól 7-ig terjed.

SaveToFileld
A képet a táblázatban vagy a Visual FoxPro változóban tárolja.

A GraphicsFormatName paraméter három karaktert tartalmaz, és megadja a grafikus formátum (BMP, JPG, GIF, TIF, PNG) típusát

SaveToFile
A képet elmenti a fájlban.

A OutputFileName paraméter megadja a kép mentéséhez használt nevet és fájltípust

SetColorGradient
A meglévő lineáris gradienskefe kezdeti és végső színeinek módosítása.

A StartColor és az EndColor paraméterek megadják a gradiens kefe kezdeti és végső színeit az ARGB módszer által visszaadott formátumban

SetColorSolidBrush
Megváltoztatja egy létező egyszínű ecset színét.

A NewColor paraméter új színt állít be a monokróm ecsettel

SetPenColor
Megváltoztatja egy meglévő toll színét.

A NewColor paraméter új tollszínt állít be

SetPenStyle
Megváltoztatja a meglévő toll stílusát.

A StyleCode paraméter új tollstílust határoz meg

SetPenWidth
Megváltoztatja a meglévő toll vastagságát.

A Szélesség paraméter határozza meg az új toll vastagságát

SetSmoothing
Grafikus primitívek rajzolásakor állítsa be vagy szüntesse meg a visszautasítást.

zászló # 8213; a logikai típus értéke; Az "igaz" létrehozza az aliasing használatát
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

SetStringFormatParameter
Beállítja a szöveges igazítási módot és a kimeneti irányt a megadott téglalap alakú területen.

igazítása # 8213; 0, 1 és 2 értéket veszi fel; a bal oldali (0), a középpontos (1) vagy a jobb oldali igazítást határozza meg
közvetlen # 8213; (opcionális) határozza meg a szövegbevitel irányát; az "igaz" értéke függőleges kimenetet jelent

A módszer használata előtt létre kell hoznia egy StringFormat objektumot (a CreateStringFormat módszerben)

SetTextRendering
Meghatározza a rajz karakterek minőségét (például beállíthatja a módot a Típus törlésére).

mód # 8213; értéke 0-tól 5-ig terjed
ObjGraphics # 8213; (opcionális) leírása a kimeneti eszközhöz társított grafikus objektumhoz; ha a paramétert elhagyják, akkor a rajz az aktuális képen kerül végrehajtásra

Hibakódok

Az osztály eljárás végrehajtása során felmerülő hibakód a GetStatus módszerrel érhető el.
Ha a GetStatus pozitív számot ad vissza, akkor azt jelenti, hogy a hiba a GDI + függvény végrehajtása közben történt. Ezeknek a hibáknak a kódjait az 1. táblázat sorolja fel.
Ha a GetStatus negatív számot ad vissza, ezt a hibát a módszer észleli. Ezeknek a hibáknak a kódjait a 2. táblázat tartalmazza.

1. táblázat: GDI hibakódok +

GdipPrinter osztály

Az osztály a képek nyomtatására, grafikai primitívumok és szövegek nyomtatására szolgál

Egy osztály példány objektumának létrehozása:

Ha a nyomtató neve elmarad, az objektum az alapértelmezett nyomtatóhoz kapcsolódik.
Az objektumnak nincsenek nyilvános tulajdonságai.

CloseDocument
Bezárja a nyomtató dokumentumát, és elküldi a nyomtatási sorba.

GetGraphics
Visszaadja a nyomtatóval társított grafikus objektum fogantyúját.

Állap.info
Visszaadja az állapotkódot az osztály módszerének végrehajtása után. A pozitív értékek azonosítják a GDI + függvények végrehajtásakor előforduló hibákat, a negatív értékek az általunk hozzáadott hibakódok. A hozzáadott hibák listája a 3. táblázatban látható. Ha a módszer nulla értéket ad, akkor nem volt hiba.

nEWPAGE
Új oldalt hoz létre a nyomtató dokumentumában.

OpenDocument
Megnyitja a nyomtató dokumentumát.

SetPageUnit
Beállítja az intézkedés mértékegységét a nyomtatóra történő nyomtatáshoz, és visszaadja a nyomtatólap méreteit a kiválasztott egységekben.

FlagUnit # 8213; logikai érték; Az "igaz" azt határozza meg, hogy a mérési egységek milliméterek, "hamis" # 8213; képpont
WidthPage, HeightPage # 8213; ezek a hivatkozott paraméterek rögzítik a nyomtató méreteinek értékét a kiválasztott mérési egység számára

Hibakódok

Az osztály eljárás végrehajtása során felmerülő hibakód a GetStatus módszerrel érhető el.
Ha a GetStatus pozitív számot ad vissza, akkor azt jelenti, hogy a hiba a GDI + függvény végrehajtása közben történt. Ezeknek a hibáknak a kódjait az 1. táblázat sorolja fel.
Ha a GetStatus negatív számot ad vissza, ezt a hibát a módszer észleli. E hibák kódjait a 3. táblázat tartalmazza.

3. táblázat: GdipPrinter osztályú hibakódok

Kapcsolódó cikkek