Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Frame - vlastnost objektu PmViewCreator

Popis:
Vrací objekt PmMap, který obsahuje parametry pro rámec (frame) ve kterém bude zobrazen prohlížeč.
Syntaxe:
PmMap Frame
Volání:
oFrame = oCreator.Frame
Poznámka:
Vlastnost je určena jen pro čtení. Do vlastností vráceného objektu PmMap však zapisovat lze a lze i přidat nové vlastnosti tohoto objektu.
 
Parametry se liší pro jednotlivé typy rámců. Existují 3 typy rámců:
- nezávislé okno (target:_blank;)
- rámec v pracovní ploše (v objektu PmaWorkspace)
- grafický objekt PmgFrame
 
Parametry jsou v podobě objektu PmMap, který je naplněn z hodnoty parametru sFrame (typu KeyVal) v metodě Pm.CreateView.

Naplněním z KeyVal hodnoty jsou všechny parametry na počátku uložené jako řetězec. Obsah objektu PmMap však může být libovolně měněn, položky lze přidávat, mazat nebo měnit jejich hodnotu.

Objekt PmMap může obsahovat jiné vnořené objekty PmMap. Ke zpřístupnění existující nebo založení nové položky typu PmMap lze využít metodu PmMap.mapSetSubmapAt.

 

Parametry společné pro všechny typy rámců:

target:xx; - Určuje, v kterém rámci se prohlížeč otevře.
Pokud není nastaveno, pak se přednastaví následovně:
- pokud se otevírá okno jako modální (je nastaveno "1"), pak se nastaví na "_blank".
- pokud se otevírá z objektu PmaPanel, pak se nastaví na "_self".
- pokud se otevírá z objektu PmaWorkspace, pak se nastaví na identifikátor hlavního rámce v této pracovní ploše (zadaný v konfigurátoru "Implicitní rámec (default frame)").
- pokud se otevírá z objektu PmgFrame, pak se prohlížeč zobrazí v objektu PmgFrame).
frameid - Nový prohlížeč se otevře v objektu PmaWorkspace v rámci s identifikátorem frameid.
_blank - Nový prohlížeč se otevře v novém okně.
_blank.blankid - Pokud existuje okno s identifikátorem blankid, pak se nový prohlížeč se otevře ve stávajícím okně, v jiném případě se otevře v novém okně. Umožňuje zabránit otevírání velkého množství oken.
_self - Nový prohlížeč se otevře ve stávajícím okně (rámci) a prohlížeč, nad kterým byla metoda volána, se zavře.
scrollbar:nn; - Určuje, zda okno bude zobrazovat scrollbary (posuvné lišty) a umožní posouvání obsahu, pokud velikost obrazu je větší než velikost okna, ve kterém je obraz zobrazován.
0 - Scrollbary nebudou nikdy zobrazeny a okno neumožní posouvání obrazu. Je to například vhodné pro okno typu "nástrojová lišta, kdy okno má být úzké a scrollbary by vadily.
1 (přednastaveno) - Okno zobrazí scrollbary a umožní posun obrazu, pokud bude velikost obrazu je větší než velikost okna, ve kterém je obraz zobrazován.
refresh:xx; - Pouze pro otevření prohlížeče objektu PmaPanel. Určuje, zda obraz bude mít automatické obnovování podle globálně nastavené systémové periody nebo bude mít vlastní obnovování. Zatím není funkční při otevření Web obrazu.
0 - Obraz bude mít vlastní obnovování, tzn. bude se volat metoda PmaPanel.Refresh.
system (přednastaveno) - Obraz bude mít automatické obnovování podle globálně nastavené systémové periody (Viz PmaRoot > Aplikace > Perioda časovače obrazů).

Parametry pouze pro rámec v nezávislém okně:

modal:nn; - Určuje, zda okno bude modální.
0 (přednastaveno) - Okno nebude modální.
1 - Okno bude modální.
dependent:nn; - Určuje, zda okno bude závislé na hlavním okně aplikace.
0 - Okno bude nezávislé na hlavním okně aplikace. Zatím není funkční při otevření Web obrazu.
1 (přednastaveno) - Okno bude závislé na hlavním okně aplikace a bude vždy nad aplikací.
caption:nn; - Určuje, zda okno bude se záhlavím (tzn. s modrou lištou nahoře).
0 - Okno bude bez záhlaví. Zatím není funkční při otevření Web obrazu.
1 (přednastaveno) - Okno bude se záhlavím.
ontop:nn; - Určuje, zda okno bude "Vždy nahoře".
0 (přednastaveno) - Okno nebude "Vždy nahoře".
1 - Okno bude "Vždy nahoře". Zatím není funkční při otevření Web obrazu.
state:xx; - Určuje počáteční stav okna.
normal (přednastaveno) - Okno bude zobrazeno normálně (nebude maximalizované ani minimalizované).
max - Okno bude zobrazeno maximalizované. Zatím není funkční při otevření Web obrazu.
pos:xx; - Určuje počáteční pozici okna v normálním stavu.

Tato pozice je jen doporučená. Pokud okno se svou velikostí nevejde na obrazovku, pak se tato pozice posune tak, aby byla viditelná co největší část tohoto okna.

top,center (přednastaveno) - Okno bude zobrazeno ve středu aktivního okna aplikace (pracovní plochy).
top,x,y - Okno bude mít levý horní roh na souřadnicích x a y (v pixelech) relativně k aktivnímu oknu aplikace (pracovní plochy).
frame,center - Okno bude zobrazeno ve středu okna, ze kterého je nové okno otevíráno.
view,x,y - Okno bude mít levý horní roh na souřadnicích x a y (v pixelech) relativně k obsahu okna, ze kterého je nové okno otevíráno.

Pozice se zde stanovuje relativně k obsahu okna (view) a ne k oknu samotnému (frame). Lze tak například nové okno umístit vedle Pmg objektu, ze kterého je okno otevíráno. Viz Příklad otevření okna s umístěním podle Pmg objektu.

screen,x,y - Okno bude mít levý horní roh na souřadnicích x a y (v pixelech) v absolutním souřadném systému Windows. Tato volba není funkční na webu. Slouží k umístění hlavních oken (PmaWorkspace nebo PmaPanel) aplikace na jednotlivé monitory. Ostatní okna aplikace se již obvykle umísťují relativně k těmto hlavním oknům.
size:xx; - Určuje počáteční velikost okna v normálním stavu.
panel (přednastaveno) - Okno bude mít takovou velikost aby se tam vešel celý otevíraný obraz (tzn. aby nevznikly scrollbary). Šířka a výška obrazu se zadává v editoru grafiky v objektu PmgRoot v záložce "Obraz".
dx,dy - Okno bude mít velikost podle zadaných hodnot dx a dy (v pixelech). Tyto hodnoty definují vnější velikost okna (tzn. včetně okrajů a záhlaví okna).
fixed:xx,yy,..; - Umožňuje zakázat změnu stavu, pozice nebo velikosti obrazu. Má podobu výčtu jednotlivých zákazů oddělených znakem "čárka" (,). Zatím není funkční při otevření Web obrazu. Přednastavená hodnota je: vše je povoleno.
state - Zakazuje měnit stav okna (normální / maximalizovaný / minimalizovaný).
pos - Zakazuje měnit pozici okna v normálním stavu.
size - Zakazuje měnit velikost okna v normálním stavu.
size2 - Omezuje změnu velikosti okna v normálním stavu - okno nemůže být větší než vlastní velikost obrazu.
Viz také:
- Pm.CreateView (metoda)
- PmViewCreator.View (vlastnost)

Historie:
Pm9.00.09: Vytvořeno
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice