GetItem - metoda obiektu PmfTreeItem

Opis:

Zwraca element drzewa na podstawie określonych parametrów.

Składnia:

Object GetItem(Long nWhat, Variant vPar, [Long nAttr])

Parametry:

nWhat	(Long) Typ ścieżki lub pozycji wymaganego elementu drzewa (obiekt typu PmfTreeItem). 0 - Zwraca element w ścieżce określonej z identyfikatorów pojedyńczych elementów drzewa. Patrz właściwość PmfTreeItem.Id. 1 - Zwraca element w ścieżce określonej z indeksów pojedyńczych elementów drzewa (indeksowane od 0). Jeżeli vPar jest liczbą (indeks), wtedy zwraca podelement o danym indeksie. 10 - Zwraca poprzedni wpis drzewa na tym samym poziomie, jako element, nad którym wywoływana jest metoda. Jeżeli metoda jest wywoływana nad pierwszym elementem na tym poziomie drzewa, wtedy zwraca null. 11 - Zwraca poprzedni element w określonej gałęzi drzewa. Element główny (korzeń) żądanej gałęzi drzewa jest określony w parametrze vPar. Jeżeli parametr vPar jest null, wtedy wyszukiwany jest poprzedni element w całym drzewie. 20 - Zwraca następny element drzewa na tym samej gałezi drzewa jak element, ponad którym została wywołana metoda. Jeżeli metoda zostanie wywołana nad ostatnim elementem określonej gałezi drzewa, wtedy zwraca null. 21 - Zwraca następny element w określonej gałęzi drzewa. Element główny (korzeń) żądanej gałęzi drzewa jest określony w parametrze vPar. Jeżeli parametr vPar ma wartość null, wtedy wyszukiwany jest następny element w całym drzewie.
vPar	(Variant) Łańcuch ze ścieżką do żądanego elementu drzewa lub indeks żądanego elementu drzewa lub odniesienie do PmfTreeItem obiektu. Wartość zależy od wartości parametru nWhat.
nAttr	[opcjonalne] (Long) Uzupełniające atrybuty. 0 (domyślnie) - Zwraca null, jeżeli wymagana dynamiczna pozycja (patrz RequestType), lub niektóra dynamiczna pozycja rodzica jeszcze nie została wczytana. Przez wywołanie metody GetItem nie zostanie wywołane zdarzenie onItemRequest. 1 - Jeżeli wymagana dynamiczna pozycja (patrz właściwość RequestType) jeszcze nie została wczytana, zostanie wywołane zdarzenie onItemRequest.

Notatka:

Metoda ta działa także w Web panelach.

Patrz również:

- PmfTreeItem (obiekt)

Przykład:

JavaScriptWybierz oraz skopiuj do schowka



var oTreeItem1 = oTreeItem.GetItem(0, "/id1/id2");
  // Ścieżka bezwzględna utworzona z identyfikatorów elementów

var oTreeItem2 = oTreeItem.GetItem(0, "../../id1/id2");
  // Ścieżka względna wytworzona z identyfikatorów elementów

var oTreeItem3 = oTreeItem.GetItem(1, 0);
  // Zwraca pierwszy podelement (podelement o indeksie 0)

var oTreeItem4 = oTreeItem.GetItem(1, "/2/5");
  // Ścieżka bezwzględna wytworzona z indeksów elementów

var oTreeItem5 = oTreeItem.GetItem(10, null);
  // Zwraca poprzedni element na tym samym poziomie drzewa

var oTreeItem6 = oTreeItem.GetItem(11, null);
  // Zwraca poprzedni element, przeszukiwane jest całe drzewo

var oTreeItem7 = oTreeItem.GetItem(11, oItemA);
  // Zwraca poprzedni element, jest on wyszukiwany w gałęzi rozpoczynającej się od oItemA

var oTreeItem8 = oTreeItem.GetItem(20, null);
  // Zwraca następujący element na tym samym poziomie drzewa

var oTreeItem9 = oTreeItem.GetItem(21, null);
  // Zwraca następujący element, przeszukiwane jest całe drzewo

var oTreeItem10 = oTreeItem.GetItem(21, oItemA);
  // Zwraca następujący element, jest on wyszukiwany w gałęzi rozpoczynającej się od oItemA