Otwarcie przeglądarki do wyboru opcji z menu (/#glob/list)

Okno do wyboru opcji z menu można otworzyć przy pomocy metody przy pomocy metody Pm.CreateView. W parametrze sViewPath należy wprowadzić ścieżkę globalną "/#glob/list".

Składnia:

JavaScriptVBScriptWybierz oraz skopiuj do schowka



var oCreator = Pm.CreateView(null, "/#glob/list", sViewPars, sFramePars);

oCreator.Open();

Parametry metody Pm.CreateView:

oFrom

(Object) Obiekt, który pośredniczy w otwarciu przeglądarki.
Obiekt określa z kąd szukać ścieżki, wobec kogo pozycjonować okno, kto będzie rodzic, itd.

- Wartość null oznacza, że zostanie zastosowany:

- obiekt PmaPanel, jeżeli metoda CreateView jest wołana w skrypcie Pmg obiektu.

- aktywny PmaWorkspace, jeżeli metoda CreateView jest wołana w skrypcie Pma obiektu.

- Jeżeli tutaj zostanie określony obiekt PmgFrame (w skrypcie Pmg obiektu), wtedy przeglądarka zostanie otwarta w tej ramce.

- Jeżeli tutaj zostanie określony obiekt PmaPanel (w skrypcie Pma obiektu), wtedy przeglądarka zostanie otwarta w tym wybranym obiekcie.

Patrz właściwość PmViewCreator.From.

sViewPars

(String) Parametry przeglądarki (różnią się w zależności od pojedyńczych typów przeglądarek).
Patrz właściwość PmViewCreator.View.
Dane są tutaj w formacie KeyVal. Na przykład "autoselect:0;grid:1;title:Wybór;".

Właściwości oraz zdarzenia w obiekcie PmViewCreator.View:

initValue	[opcjonalne] (String) Wybór początkowy (Identyfikator).
list	(Array) tablica 2-wymiarowa z opcjami, gdzie wiersze przedstawiają poszczególne opcje a kolumny przedstawiają pozycje wyboru. Patrz (Col,Row) - tablica 2-wymiarowa mniemana jako tablica wierszy. Pierwsza kolumna (indeksowane od 0) nie jest wyświetlona w ofercie (jest ukryta) oraz zawiera identyfikatory poszczególnych opcji. Następne kolumny już będą widoczne w ofercie. Oferta jest wyświetlana w formie tabelkowej i posiada o jedną kolumnę mniej niż dane dostarczone w 2-wymiarowej tablicy. Pierwszy wiersz może (lecz nie musi) zawierać nagłówek z nazwami kolumn (lokalizowane nazwy użytkownika) w ofercie. Jeżeli pierwszy wiersz powinien zawierać nagłówek, wtedy w pierwszej kolumnie (nie widzialnej, zarezerwowanej dla indetyfikatorów) musi być wprowadzony łańcuch o wartości $title.
autoselect	[opcjonalne] (Long) (Long) Umożliwia tryb, kiedy system nie oczekuje na dokonanie wyboru przez użytkownika w tych przypadkach, kiedy nie jest to konieczne. W takim przypadku nie dojdzie nawet do wyświetlenia okna. 0 (domyślnie) - okno będzie zawsze wyświetlone. 1 - Okno będzie wyświetlone tylko jeżeli do wyświetlenia są przynajmniej dwie opcje. Jeżeli do dyspozycji jest tylko jedna opcja, wtedy jest ona automatycznie wybrana a metoda zwraca wartość typu String (identyfikator wybranej opcji). Jeżeli nie ma do dyspozycji żadnej opcji, wtedy metoda zwraca: null dla JavaScript lub Empty dla VBScript (można sprawdzić przy pomocy metody Pm.IsValid).
grid	[opcjonalne] (Long) Określa, czy komórki wyświetlonej tabeli będą mieć obrzeże. 0 (domyślnie) - Komórki nie będą z obrzeżem. 1 - Komórki będą z obrzeżem.
title	[opcjonalne] (String) Nagłówek okna, jeżeli okno z nagłówkiem jest w ogóle wyświetlone (dla target:_blank;)
multiselect	[opcjonalne] (Long) Zezwoli lub zablokuje wielokrotny wybór opcji. Jeżeli wielokrotny wybór opcji jest zezwolony, wtedy w lewej części tabeli zostanie wyświetlona kolumna z polami wyboru. Przez zaznaczanie poszczególnych pól wyboru w poszczególnych wierszach można dodawać opcje do wielokrotnego wyboru, lub przez usunięcie zaznaczenia te opcje są usuwane z wielokrotnego wyboru. Jeżeli tabelka posiada nagłówek, wtedy w lewej kolumnie zostanie wyświelone pole wyboru, za pomocą którego można zaznaczyć wszystkie opcje lub usunąć je jednocześnie z wyboru. Jeżeli wybór wielokrotny jest zezwolony, wtedy parametr ev.ReturnValue zawiera tablicę PmArray identyfikatorów poszczególnych zaznaczonych opcji oraz parametr ev.ReturnIndex zawiera tablicę PmArray indeksów poszczególnych zaznaczonych pozycji w oryginalnej niezesortowanej tablicy. 0 (domyślnie) - Wybór wielokrotny jest zablokowany 1 - Wybór wielokrotny jest zezwolony
filterEnable	[opcjonalne] (Long) Zezwoli lub zablokuje możliwość filtrowania wierszy tabeli. Jeżeli filtrowanie jest zezwolone, wtedy w lewym górnym rogu okna zostanie wyświetlony przycisk "Filtr". Po jego naciśnięciu zostanie otwarte okno do wprowadzenia wyszukiwanego tekstu. Jeżeli wyszukiwany tekst nie jest pusty, wtedy zostaną wyświetlone tylko te wiersze tabeli, w których wpisany tekst został znaleziony. Pozostałe wiersze tabeli zostaną niewidoczne. Jednocześnie wyszukiwany tekst zostanie wyświetlony w prawo od przysicku "Filtr". Jeżeli wyszukiwany tekst jest pusty, wtedy to zostaną wyświetlone wszystkie wiersze tabeli. 0 (domyślnie) - Filtrowanie wierszy tabeli jest zablokowane. Przycisk "Filtr" nie zostanie wyświetlony. n - Filtrowanie wierszy tabeli jest zezwolone, jeżeli jeżeli ilość wierszy tabeli jest większa lub równa "n". Zatem np. określona wartość 10 oznacza, że przycisk "Filtr" zostanie wyświelony, jeżeli tabelka będzie zawierać przynajmniej 10 wierszy.
filterCol	[opcjonalne] (Variant) Określa, w których kolumnach tabeli będzie podczas filtrowania wyszukiwany wpisany tekst. all (domyślnie) - Wpisany tekst będzie wyszukiwany we wszystkich kolumnach tabeli. n - Wpisany tekst będzie wysukiwany tylko w kolumnie o indeksie "n".
font	[opcjonalne] (String) Czcionka, która zostanie zastosowana w oknie do wyboru opcji z menu. Nleży ustawić w formacie: font-style font-variant font-weight font-size font-family - Łańcuch tekstowy w formacie CSS. Jeżeli nie zostanie określone, wtedy jako wartość domyślna zostanie wykorzystana czcionka określona w konfiguratorze "Stosuj inną czcionkę w oknach systemowych". Domyślną wartością jest "normal normal 400 11px 'Microsoft Sans Serif'".
onChange	[opcjonalne] (Function) Funkcja zdarzenia do opracowania zdarzenia zmiany w przeglądarce. Dla JavaScript należy określić function. Dla VBScript należy określić obiekt PmAction. Funkcja posiada jeden parametr ev zawierający informacje o danym zdarzeniu. ev.Value - (String) Aktualnie wybrana opcja (Identyfikator). ev.Index - (Long) Indeks aktualnie wybranego wyboru w oryginalnej nieposortowanej tablicy.
onClose	[opcjonalne] (Function) Funkcja zdarzenia do opracowania zdarzenia zamknięcia przeglądarki. Dla JavaScript należy określić function. Dla VBScript należy określić obiekt PmAction. Funkcja posiada jeden parametr ev zawierający informacje o danym zdarzeniu. ev.CloseReason - (String) Identyfikator typu zamknięcia okna. Wartość "ok" oznacza ważny wybór. Wartość "cancel" lub "" oznaczają anulowany wybór. ev.ReturnValue - Identyfikator (Łańcuch) zaznaczonej opcji, lub tablica PmArray identyfikatorów poszczególnych zaznaczonych opcji, jeżeli w tabelce jest zezwolona opcja wielokrotnego wyboru. ev.ReturnIndex - Indeks zaznaczonej opcji w oryginalnej nieposortowanej tablicy, lub tablica PmArray indeksów poszczególnych zaznaczonych opcji, jeżeli w tabelce jest zezwolona opcja wielokrotnego wyboru.

sFramePars

(String) Parametry dla ramki (frame), w której przeglądarka zostanie wyświetlona.
Patrz właściwość PmViewCreator.Frame.
Dane są tutaj w formacie KeyVal, na przykład "target:_blank;".

Parametry przeglądarki są w formie obiektu PmMap, który jest napełniony z wartości parametru sViewPars (typu KeyVal) w metodzie Pm.CreateView.
Napełnieniem z KeyVal wartości wszystkie parametry są na początku zapisane w postaci łańcucha. Zawartość obiektu PmMap może zostać w dowolny sposób zmieniona - pozycje można dodawać, usuwać lub zmieniać ich wartość.
Obiekt PmMap może zawierać inne wżłobione obiekty PmMap. W celu udostępnienia istniejącej lub wytworzenia nowej pozycji typu PmMap można zastosować metodę PmMap.mapSetSubmapAt.

Przykład1:

Wybór z tablicy wartości

JavaScriptWybierz oraz skopiuj do schowka



var aList = Pm.CreatePmArray().Create(2,3);

aList.SetItem("id1", 0, 0);

aList.SetItem("Test 1", 1, 0);

aList.SetItem("id2", 0, 1);

aList.SetItem("Test 2", 1, 1);

aList.SetItem("id3", 0, 2);

aList.SetItem("Test 3", 1, 2);


function onViewClose(ev)

{

	if (ev.CloseReason == "ok")

	{

		switch (ev.ReturnValue)

		{

			case "id1":

				Pm.Debug("Run test 1");

				break;

			case "id2":

				Pm.Debug("Run test 2");

				break;

			case "id3":

				Pm.Debug("Run test 3");

				break;

		}

	}

}


var oCreator = Pm.CreateView(null, "/#glob/list", "autoselect:0;grid:1;title:Wybór;", "target:_blank;modal:1;pos:view," + pMe.ViewX + "," + pMe.ViewY + ";");

oCreator.View.list = aList;

oCreator.View.initValue = "id2";

oCreator.View.onClose = onViewClose;

oCreator.Open();

Przykład2:

Wybór z listy paneli.
Metoda Pm.FindViewers zwraca tablicę do wyboru.

JavaScriptWybierz oraz skopiuj do schowka



function onViewClose(ev)

{

	if (ev.CloseReason == "ok")

	{

		var sViewer = ev.ReturnValue;

		if (Pm.IsValid(sViewer))

		{

			Pm.CreateView(null, sViewer, "", "target:main;").Open();

		}

	}

}


var oCreator = Pm.CreateView(null, "/#glob/list", "autoselect:0;grid:1;title:Wybór;", "target:_blank;modal:1;pos:view," + pMe.ViewX + "," + pMe.ViewY + ";");

oCreator.View.list = Pm.FindViewers("groups:menu;viewers:panel;\",\"\", \"headers:;columns:path,title;");

oCreator.View.onClose = onViewClose;

oCreator.Open();