Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Print - metoda objektu PmPanel

Popis:
Tisk obrazu (nebo jeho části) na tiskárnu nebo do souboru.
Syntaxe:
Print([nAttr As Long], [sOptions As String], [sParams As String]) As Boolean
Volání:
oPanel.Print
Parametry:
nAttr[nepovinné] (Long) Parametr určujíci zda bude obraz tisknut
0 (přednastaveno) - novým způsobem
1 - starým způsobem
sOptions[nepovinné] (String) Textový seznam dodatečných parametrů definující způsob tisku (výřez, atd.). Neuvede-li se, tiskne se celý obraz s implicitními nastaveními. Hodnota parametru sOptions se bere i z výchozího statického nastavení objektu, viz Výchozí hodnota sOptions. Údaje s přiřazenou hodnotou jsou zde odděleny středníkem, například "x:0;y:0;dx:300;dy:200;printer:select;printzoom:0;".
"x:nn;" (nepovinné) - Pozice x levého horního bodu výřezu (v pixelech, přednastaveno 0).
"y:nn;" (nepovinné) - Pozice y levého horního bodu výřezu (v pixelech, přednastaveno 0).
"dx:nn;" (nepovinné) - Velikost x výřezu (v pixelech, přednastaveno 0 = celý obraz).
"dy:nn;" (nepovinné) - Velikost y výřezu (v pixelech, přednastaveno 0 = celý obraz).
"printer:xx;" (nepovinné) - Umožňuje nastavit a vybrat tiskárnu pro tisk.
select (přednastaveno) - Při tisku bude zobrazeno okno pro výběr a nastavení vlastností tiskárny.
default - Tisk se provede na implicitní tiskárně OS Windows.
pmprinter_path - Cesta (absolutní) k objektu PmPrinter, který v sobě nese informaci o tiskárně určené pro tisk (např. "printer:/printer0;").
file:filepath - Název souboru (*.bmp, *.png, *.jpg, *.gif nebo *.tif) s cestou, do kterého bude obraz nebo jeho výřez uložen. Přípona souboru určuje formát uložení. Je doporučeno použít cestu v syntaxi PROMOTIC - viz PROMOTIC cesta k souborům nebo složkám. Výsledná velikost obrázku v souboru bude dána velikostí celého obrazu nebo velikostí výřezu.
"printzoom:nn;" (nepovinné) - Výsledná velikost obrázku v souboru bude dána velikostí celého obrazu nebo velikostí výřezu.
sParams[nepovinné] (String) Umožňuje nastavit hodnotu parametrů grafického prvku PmiRoot. Tento parametr je pak přístupný v konfigurátorech obrazu pomocí Makro výraz $.par a ze skriptu pomocí metody GetPar. Každý jednotlivý parametr je tvořen identifikátorem (název) a hodnotou. Syntaxe: "par:name1=value1;par:name2=value2; ...". Viz také: Parametry grafického prvku. Hodnota parametru sParams se bere i z výchozího statického nastavení objektu. Viz Výchozí hodnota sParams.
Poznámka:
Pokud se tato metoda vyvolá nad obrazem, který není otevřen, obraz se neviditelně otevře a po tisku zavře. Přitom se nevyvolají události onOpen a onClose.
 
Tato metoda není funkční pro Web Obrazy. Je lepší použít metodu PmiRoot.Print.
Příklad1:
Tisk celého obrazu. Obraz bude roztažen přes celý papír (bez zdeformování) a bude zobrazeno okno pro výběr a nastavení vlastností tiskárny.
pMe.Pm("/panel").Print
Příklad2:
Tisk výřezu části obrazu, kde výřez začíná na pozici 100,100 a jeho velikost je 300,200. Obraz bude roztažen přes celý papír (bez zdeformování) a bude zobrazeno okno pro výběr a nastavení vlastností tiskárny.
pMe.Pm("/panel").Print0, "x:100;y:100;dx:300;dy:200;"
Příklad3:
Tisk celého obrazu do souboru #temp:panel.png;. Výsledná velikost obrázku v souboru bude dána velikostí celého obrazu nebo velikostí výřezu.
pMe.Root.Print 0, "printer:file:#temp:panel.png;"
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice