Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Obiekt PmAction (Akcja)

Opis:
Obiekt przedstawia akcję, którą można później wywołać.
Właściwości i metody:
Call Wywołanie akcji
PrivateData Obiekt zawierający projektantem zdefiniowane właściwości
Notatka:
- Obiekt można wytworzyć przy pomocy metody Pm.CreatePmAction.
- Obiekt ten działa również w przypadku Web panelach. Lecz nie funkcjonuje w przeglądarce InternetExplorer8 i starszych.
 
Obiekt PmAction jest odpowiedni wtedy, jeżeli istnieje potrzeba by "ktoś" wytworzył ten obiekt (tzn. wytworzył "akcję"), obiekt ten przekazał w dowolne miesjce a później "ktoś kiedyś" daną akcję wywołał. Ważnym jest, że ten "ktoś" tylko wywoła metodę Call i wogóle nie musi znać zawartości (np. nie wie, że ponad dowolnym obiektem zostanie wywołana dowolna metoda projektanta z jakimś parametrem,).
 
Sposoby stosowania obiektu PmAction:

Wytworzoną akcję można użytkować na dwa sposoby:

1. Można ją ustawić do komponentu systemowego w taki sposób, że ten komponent wywoła akcję samodzielnie aż będzie potrzebna.

W tym przypadku projektant nie woła metodę Call. Tą metodę woła komponent systemowy a podczas wołania może ustawić różne ważne informacje w właściwościach obiektu, który jest poźniej dostępny w wołanej metodzie użytkownika w parametrze oSystem.

Przykłady komponent systemowych, w których można ustawić PmAction:

- W metodzie OpenView można ustawić akcję w danej oExtra.onClose. Akcja zostanie wywołana podczas zamykania panela a w parametrze oSystem zostanie ustawiona właściwość ReturnValue.
2. Projektant korzysta z akcji dla swoich potrzeb i później woła metodę Call kiedy uzna za stosowne.

Przykład wytworzenia oraz zastosowania obiektu PmAction:
Wytworzy akcję: W tej częsci zostanie wytworzona akcja typu "wołanie metody projektanta" o nazwie "MyMeth1" w obiekcie, w którym znajduje się ten skrypt (obiekt ten jest dostępny przy pomocy zmiennej pMe).

Równocześnie zostaną ustawione projektantem wprowadzane właściwości w obiekcie PrivateData: właściwość "id" i "val". Właściwości te będą dostępne podczas wołania akcji.

Wołanie akcji: W tej części zostanie akcja wywołana. Skrypt ten może zostać wywołany "kimkolwiek gdziekolwiek", musi tylko posiadać dostęp do wytworzonej akcji (dostęp do wartości oAction). Jeżeli akcja została ustawiona w dowolnym komponencie systemowym, wtedy projektant nie woła metody Call (jest wołana sestemem).

Tym wołaniem zostanie wywołana metoda projektanta "MyMeth1" (metoda zdefiniowana w zakładce Metody), która musi posiadać dwa parametry:

- oSystem: Obiekt typu PmMap. Właściwości tego obiektu ustawia system wg tego skąd dana akcja jest wołana.
- oPrivate: Obiekt typu PmMap. Właściwości tego obiektu ustawia projektant w obiekcie PmAction.PrivateData.

To znaczy, że obiekt ten zawiera wcześniej ustawione właściwości "id" i "val".

JavaScriptVBScriptWybierz oraz skopiuj do schowka

//Wytworzy akcję
var oAction = Pm.CreatePmAction(1, pMe, "MyMeth1");
oAction.PrivateData.id = "Temperatura";
oAction.PrivateData.val = 56;
//Wołanie akcji
oAction.Call();
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice