Promotic

Objekt PmgButton (Tlačítko jednostavové)

Popis:
Jednostavové tlačítko je určeno ke spouštění skriptu (např. přepnutí do jiného obrazu, přenos hodnoty, přehrání zvukového souboru,...).
Skript se definuje v události onButtonDown nebo onButtonUp.
Tento objekt přebírá vlastnosti, metody a události objektu PmgBox.
Vlastnosti a metody tohoto objektu:
ColorText Barva textu v tlačítku
ImageSrc Název souboru s cestou k obrázku zobrazeného v tlačítku
StateEx Vrací stav tlačítka
Text Text v tlačítku
Vlastnosti a metody zděděné z objektu PmgBox:
BorderType Typ okraje boxu
BorderWidth Šířka okraje boxu
ColorDark Barva ztmavení 3D okraje Pmg objektu
ColorItem Barva pozadí boxu
ColorLight Barva zesvětlení 3D okraje Pmg objektu
Vlastnosti a metody zděděné z objektu PmgObject:
AddEvent Zaregistruje funkci do zadané události
Blink Spustí/zastaví blikání Pmg objektu
Dx Šířka Pmg objektu
Dy Výška Pmg objektu
Enabled Povolení/zákaz ovládání, tzn. uživatelských vstupů na objekt
Focus Zjistí/nastaví fokus Pmg objektu
GetChildByIndex Vrací vnořený Pmg objekt určený pořadím
GetChildCount Vrací počet vnořených Pmg objektů
GetPathName Název objektu s cestou k tomuto objektu
GetItemInfo Vrací speciální informace o Pmg objektu
GetPar Čtení hodnoty parametru Pmg objektu (nebo jeho rodičů)
IniDx Počáteční šířka Pmg objektu
IniDy Počáteční výška Pmg objektu
IniX Počáteční pozice X levého horního rohu Pmg objektu relativně k nadřízenému objektu
IniY Počáteční pozice Y levého horního rohu Pmg objektu relativně k nadřízenému objektu
Items Vrací referenci na Pmg objekt
Methods Přístup k metodám projektanta tohoto objektu
MouseOn Identifikace, zda kurzor myši se nachází nad Pmg objektem
Name Název Pmg objektu
Parent Vrací referenci na nadřazený Pmg objekt
Pm Vrací Pma objekt (zastaralé)
PmPanel Vrací referenci na objekt PmaPanel, ve kterém je Pmg objekt umístěn
Refresh Překreslení Pmg objektu
RemoveEvent Odregistruje funkci v zadané události
Root Vrací referenci na kořenový objekt PmgRoot
ShowMenu Otevře lokální menu Pmg objektu
ScreenX Pozice X levého horního rohu Pmg objektu relativně k obrazovce počítače
ScreenY Pozice Y levého horního rohu Pmg objektu relativně k obrazovce počítače
ToolTip Tooltip (text) rychlé nápovědy Pmg objektu
Vars Vrací proměnnou Pmg objektu
ViewX Pozice X levého horního rohu Pmg objektu relativní k objektu PmgRoot
ViewY Pozice Y levého horního rohu Pmg objektu relativní k objektu PmgRoot
Visible Nastaví viditelnost/neviditelnost Pmg objektu
X Pozice X levého horního rohu Pmg objektu relativně k nadřízenému Pmg objektu
Y Pozice Y levého horního rohu Pmg objektu relativně k nadřízenému Pmg objektu
Události tohoto objektu:
onButtonDown Vyvolá se po stisknutí tlačítka
onButtonUp Vyvolá se při uvolnění tlačítka
Události zděděné z objektu PmgObject:
onStart Vyvolá se při konstrukci Pmg objektu během otvírání obrazu
onStop Vyvolá se při destrukci Pmg objektu během zavírání obrazu
onRefresh Vyvolá se při obnovování dat Pmg objektu
onKeyPress Vyvolá se po stisknutí nebo uvolnění klávesy klávesnice
onMousePress Vyvolá se po stisknutí nebo uvolnění levého tlačítka myši
onMenuFill Vyvolá se po stisknutí pravým tlačítkem myši nad Pmg objektem
onMenuSelect Vyvolá se při vybrání položky z lokálního menu Pmg objektu
onModeChange Vyvolá se při změně módu Pmg objektu
onFocusIn Vyvolá se pokud objekt získá fokus
onFocusOut Vyvolá se pokud objekt ztratí fokus
Konfigurační karty:
Objekt Obecné informace o daném objektu
Pozice Nastavení pozice, délky a výšky Pmg objektu
Proměnné Seznam a konfigurace uživatelem definovaných proměnných Pmg objektu
Události Definice algoritmů pro události objektu
Metody Definice metody projektanta Pmg objektu
Box Nastavení podkladové plochy Pmg objektu
Tlačítko Vlastnosti tlačítka.
Poznámka:
Pokud ve skriptu je metoda vyvolávající jakékoli modální okno (např. Pm.InputBox), pak je nutno umístit takový skript do události onButtonUp (v jiném případě OS Windows nemusí zajistit, že se tlačítko vykreslí správně).
 
Tlačítko může být vykresleno s obrázkem. Ten se může měnit datovou vazbou "T - Datová vazba na výpočet podle tabulky hodnot" v závislosti na stavu stisknutí tlačítka (viz vlastnost StateEx).
Viz také:
- PmgButtonState (objekt)

Historie:
Pm9.00.00: Změna názvu objektu: PmiButton -> PmgButton
Pm8.00.13: Další menší opravy chyb týkající se objektu.
Pm8.00.07: Zprovozněno zarovnání ikony s textem. Pokud například konfigurátor "Zobrazit obrázek" je nastaven na "vlevo od textu" a text je přitom zarovnán vlevo, pak se ikona spolu s textem zarovná vlevo (dříve se bez ohledu na nastavení centrovalo). Toto je funkční i pro Web obrazy.
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice