Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Pm - metoda obiektu PmaObject

Opis:
Zwraca odniesienie do Pma obiektu lub do jego podobiektu iplementacyjnego.
Składnia:
Object Pm(String sPath, [Long nAttr])
Wołanie:
obj = oObject.Pm(sPath)
Parametry:
sPath(String) Ścieżka względna lub bezwzględna do Pma obiektu w drzewie Pma obiektów (rozróżnia duże/małe litery).

Ścieżka opisuje ulokowanie obiektu w drzewie Pma obiektów. Adresacja poszczególnych poziomów drzewa jest oddzielona znakiem /. Do zagnieżdżonego Pma obiektu podrzędnego odnosi się jego nazwą. Do nadrzędnego Pma obiektu odnosi się przy pomocy znaków .. . Do zagnieżdżonego podobiektu implementacyjnego (nie jest typu PmaObject) odnosi się przy pomocy znaku #, za którym znajduje się typ podobiektu implementacyjnego (np. #vars). To znaczy, że adresacja # opuszcza drzewo Pma obiektów (wytworzone przez użytkownika) i zaczyna adresować podobiekty implementacyjne Pma obiektu. Na przykład "/appdata/data/#vars/Temperatura".

nAttr[opcjonalne] (Long) umożliwia zmianę zachowania funkcji.
0 (domyślnie) - zachowanie standardowe.
1 - przy odniesieniu do nie istniejącego obiektu nie zostanie wygenerowany globalny błąd w INFO systemie.
Notatka:

Przy pomocy niniejszej metody można uzyskać odniesienie do danego obiektu względem do obiektu, w którym niniejsza metoda została wywołana. W parametrze sPath nie musi się zatem znajdować zupełna ścieżka (ścieżka bezwzględna, lecz ścieżka względna. Ścieżka względna określa się bez ukośnika (/). Jeżeli jest potrzebne odnieść się do obiektu nadrzędnego (rodzicielskiego), wtedy można wprowadzić 2 kropki (tak jak jest zwyczajne na przykład przy wprowadzaniu ścieżki względnej do plików w SO Windows).

Jeżeli ścieżka określona przez parametr sPath rozpoczyna się ukośnikiem (/), wtedy jest uważana za bezwzględną, tzn. ścieżka jest określona względem do głównego obiektu aplikacji - względem do obiektu PmaRoot.

 
Identyfikator #vars: Do obiektu PmVar można się również odnosić bezpośrednio rozszerzeniem ścieżki metody Pm przy pomocy identyfikatora #vars. Identyfikatore te można zastosować w metodzie Pm, lub w powiązaniu danych PP w aplikacji oraz w panelach. Na przykład metoda Pm("/data/#vars/Temperatura) zwraca zmienną "Temperatura" (PmVar) w obiekcie "data" (PmaData).
 
Identyfikator #ext: Do obieków Rozszerzenia danych w zmiennej PmVar można się również odnosić bezpośrednio rozszerzeniem ścieżki metody Pm za pomocą identyfikatora #ext. Można zastosować w metodzie Pm lub w powiązaniu danych PP w aplikacji oraz w panelach. Na przykład metoda pMe.Pm("/data/#vars/Temperatura/#ext/al") zwraca rozszerzenie danych z identyfikatorem al (ExtAlarmAnalog) w zmiennej "Temperatura" (PmVar) w obiekcie "data" (PmaData).
 
W celu wytworzenia zmiennej typu Object zawierającą odniesienie do Pma obiektu w drzewie Pma obiektów lub do jego podobiektu implementacyjnego. Patrz również: #pragma variable x = PmaObjectRef("ścieżka").
Przykład:
JavaScriptVBScriptWybierz oraz skopiuj do schowka

//Uzyska odniesienie do Pma obiektu przy pomocy ścieżki bezwzględnej:
o = oObject.Pm("/Kociol1/Temperatura");

//Uzyska odniesienie przy pomocy ścieżki względnej. Obiekt zostanie wyszukany na tym samym poziomie w drzewie obiektów jak obiekt, w którym niniejsza metoda została wywołana:
o = oObject.Pm("../Temperatura");

//Uzyska odniesienie przy pomocy ścieżki względnej. Obiekt zostanie wyszukany między obiektami podrzędnymi obiektu, w którym niniejsza metoda została wywołana:
o = oObject.Pm("Temperatura");

//Uzyska odniesienie do podobiektu PmVar obiektu PmaData:
oVar = pMe.Pm("/Kociol1/Data/#vars/Temperatura");

//Stwierdzi istnienie określonego obiektu (ewentualny błąd nie zostanie wygenerowany do INFO systemu):
o = oObject.Pm("/Kociol1/Temperatura", 1);
if (o)
//...
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice