GridWidget PDF Drukuj

Atrybuty

  • caseSensitive - określa, czy przy sortowaniu rozróżniana jest wielkość liter (wartość domyślna: true)
  • multiSelect - określa, czy zaznaczonych może być więcej niż jeden wiersz (wartość domyślna: true)
  • selectClass - klasa zaznaczonego wiersza
  • exclude - tablica zawierająca wiersze wykluczone z zaznaczania
  • excludeFirstRow - określa, czy wykluczyć pierwszy wiersz przy sortowaniu (wartość domyślna: true)
  • excludeLastRow - określa, czy wykluczyć ostatni wiersz przy sortowaniu (wartość domyślna: false)
  • remoteRowSeparator - separator oddzielający wiersze pobrane z serwera (wartość domyślna: ";") (w wersjach przed 1.2.4 wartością domyślną było "\r\n")
  • remoteDataSeparator - separator oddzielający dane wiersza pobrane z serwera (wartość domyślna: ",")
  • supportPolishChars - sortowanie polskich znaków (wartość domyślna: true)
  • reqConfig - ustawienia zapytań wysyłanych przez kontrolkę (patrz Uwagi)
  • OnSelect(row) - funkcja wywoływana po zaznaczeniu wiersza
    • row - zaznaczony wiersz
  • OnDeselect(row) - funkcja wywoływana po odznaczeniu wiersza
    • row - odznaczony wiersz
  • OnSort(index) - funkcja wywoływana przy sortowaniu tabel
    • index - numer kolumny sortującej
  • OnAscSort(index) - funkcja wywoływana przy sortowaniu rosnącym tabeli
    • index - numer kolumny sortującej
  • OnDescSort(index) -funkcja wywoływana przy sortowaniu malejącym tabeli
    • index - numer kolumny sortującej
  • OnChange(cell) - funkcja wywoływana przy zmianie kolumny sortującej
    • cell - komórka poprzedniej kolumny sortującej
  • OnInsert(row) - funkcja wywoływana przy wstawianiu nowego wiersza
    • row - wstawiany wiersz
  • OnDelete(row) - funkcja wywoływana przy usuwaniu wiersza
    • row - usuwany wiersz
  • OnRemoteLoading() - funkcja wywoływana podczas oczekiwania na odbiór danych z serwera
  • OnRemoteDone() - funkcja wywoływana po odebraniu danych z serwera
  • OnError() - funkcja wywoływana przy wystąpieniu błędu w odbiorze danych z serwera

Metody

  • AddSortCell(index) - ustawia daną kolumnę jako sortowalną
    • index - numer kolumny
  • AddSortCells(index_1, index_2, ...) - dodaje kilka kolumn sortowalnych na raz; funkcja może być również wywołana bez żadnych argumentów - w takim wypadku wszystkie kolumny zostaną ustawione jako sortowalne
    • index_1, index_2, ... - kolejny numery kolumn, które mają zostać ustawione jako sortowalne
  • SortBy(index, [desc]) - sortuje tabelę według kolumny o podanym numerze
    • index - numer kolumny
    • desc - wartość true oznacza sortowanie malejące, false rosnące (wartość domyślna: true)
  • SetSelective() - ustawia zaznaczanie wierszy
  • LoadTextData(url) - dynamicznie pobiera dane z serwera i wstawia je do tabeli; wiersze oddzielone są znakiem określonym w atrybucie remoteRowSeparator, natomiast dane oddzielone są znakiem określonym w atrybucie remoteDataSeparator
    • url - adres, skąd pobrane mają zostać dane
  • LoadJSONData(url) - dynamicznie pobiera dane z serwera w formacie JSON i wstawia je do tabeli; każdy wiersz powinien być osobnym obiektem, zawierającym tablicę danych (patrz Uwagi)
    • url - adres, skąd pobrane mają zostać dane
  • SelectAll() - zaznacza wszystkie wiersze
  • DeselectAll() - odznacza wszystkie zaznaczone wiersze
  • IsSelected(row) - sprawdza, czy dany wiersz jest zaznaczony
    • row - element wiersza lub jego pozycja
  • GetRow(index) - zwraca wiersz na danej pozycji
  • GetSelRows() - zwraca tablicę zaznaczonych wierszy
  • DeleteRow(row) - usuwa dany wiersz
    • row - element wiersza lub jego pozycja
  • DeleteSelRows() - usuwa zaznaczone wiersze
  • DeleteAllRows() - usuwa wszystkie wiersze
  • InsertRow(values) - wstawia nowy wiersz z danymi na końcu tabeli; zwraca wstawiony wiersz
    • values - dane kolejnych komórek wiersza; mogą być przekazane albo w postaci tablicy, albo jako osobne argumenty
  • InsertBefore(before, values) - wstawia nowy wiersz z danymi przed podanym; zwraca wstawiony wiersz
    • before - element wiersza lub jego pozycja, przed którym wstawiony zostanie nowy wiersz
    • values - dane kolejnych komórek wiersza; mogą być przekazane albo w postaci tablicy, albo jako osobne argumenty

Uwagi

  • Dane pobierane dynamicznie z serwera w formacie JSON powinny zostać zwrócone w poniższej postaci:

    [
        ["komorka1_wiersz1", "komorka2_wiersz1", "komorka3_wiersz1"],
        ["komorka1_wiersz2", "komorka2_wiersz2", "komorka3_wiersz2"]
    ]
  • Atrybut reqConfig zawiera ustawienia zapytań wysyłanych przez kontrolkę w postaci obiektu zawierającego pary "atrybut: wartość", przykładowe ustawienia:

    grid.reqConfig = {
        username: "lorem",
        password: "ipsum",
        encoding: "iso-8859-2"
    }
 
« poprzedni artykuł   następny artykuł »