Page History

...

getColumnName - pobiera nazwę kolumny w tabeli dynamicznej z uwzględnieniem tłumaczenia (widoczną w nagłówku).

Parametry funkcji:

Nazwa	Typ	Wartość domyślna	Opis
variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
variableId	String	null	Zmienna procesu identyfikująca kolumnę w tabeli dynamicznej

Rezultat funkcji:

Typ Opis
String Nazwa kolumny w tabeli dynamicznej lub null, jeżeli kolumna o podanym identyfikatorze nie istnieje w tabeli

setColumnName - ustawia nazwę kolumny w tabeli dynamicznej (widoczną w nagłówku), zachowuje informację o opisie i wymagalności zmiennej.

Parametry funkcji:

Nazwa	Typ	Wartość domyślna	Opis
variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
variableId	String	null	Zmienna procesu identyfikująca kolumnę w tabeli dynamicznej
name	String	null	Nazwa kolumny

Rezultat funkcji: brak

addTool - dodaje przycisk narzędzia do nagłówka tabeli dynamicznej.

Parametry funkcji:

Nazwa	Typ	Wartość domyślna	Opis
variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabeli dynamicznej
tool	Object/Ext.panel.Tool	null	Obiekt konfiguracyjny narzędzia (podawany do tworzenia Ext.panel.Tool)

Rezultat funkcji: brak

getTitle - zwraca tytuł tabeli dynamicznej bez tagów HTML.
- Parametry funkcji:
  
  Nazwa Typ
  Wartość domyślna
  Opis
  variableSet Suncode.form.view.gadget.variableset.VariableSet null Komponent tabeli dynamicznej
- Rezultat funkcji:
  
  Typ Opis
  String Tytuł tabeli dynamicznej bez tagów HTML

getInfo - zwraca informacje o tabeli dynamicznej.

Parametry funkcji:

Nazwa Typ
Wartość domyślna
Opis
variableSet Suncode.form.view.gadget.variableset.VariableSet null Komponent tabeli dynamicznej

Rezultat funkcji:

Typ

Opis

Object

Obiekt zawierający informacje o tabeli dynamicznej. Obiekt posiada następujące właściwości:

- id (Typ String)

Identyfikator tabeli dynamicznej

- originalName (Typ String)

Oryginalny tytuł tabeli dynamicznej (właściowiść DT_TABLE_NAME z konfiguracji)

- title (Typ String)

Tytuł tabeli dynamicznej bez tagów HTML

- columns (Typ Array)

Tablica informacji o poszczególnych kolumnach. Każdy element jest typu Object i zawiera następujące właściwości:

- id (Typ String)

Identyfikator zmiennej procesu

- name (Typ String)

Nazwa kolumny tabeli dynamicznej (nazwa zmiennej procesu) z uwzględnieniem tłumaczenia (nazwa widoczna w nagłówku)

- editable (Typ Boolean)

Informuje, czy kolumna jest edytowalna

- hidden (Typ Boolean)

Informuje, czy kolumna jest ukryta

addRenderer (od 3.1.6) - pozwala na dodanie dowolnej funkcji renderującej wartość komórki w tabelce dynamicznej. Zarejestrować można dowolną liczbę rendererów, które zostaną wywołane zgodnie z kolejnością dodania.

Parametry funkcji:

Nazwa

Typ

Wartość domyślna

Opis

variableSet

Suncode.form.view.gadget.variableset.VariableSet

null

Komponent tabeli dynamicznej

renderer

Function

null

Funkcja renderująca wartość danych kolumn. Przyjmuje następujące parametry:

- value: wartość komórki (nie formatowana)

- data: obiekt całego rekordu (wiersza)

Code Block

	js
	js

{
	"id_zmiennej": "wartość",
	"id_zmiennej2": "wartość2"
}

- column: identyfikator aktualnie renderowanej kolumny (id zmiennej)

- metaData: obiekt zawierający informacje o wierszu

Code Block

	js
	js

{
	row: //indeks wiersza (readonly)
	cell: //indeks kolumny (readonly)
	style: //nadany styl elementu TD
	cls: // nadana klasa css elementu TD
 
	// 3.1.7+
	encode: // czy kodować znaki html (domyślnie true)
}

Warning
Parametr metaData.encode może być wykorzystany w przypadku, gdy chcemy w komórce wstawić tagi html. W takim przypadku musimy sami zadbać o zakodowanie wartości wpisanej przez użytkownika.

Funkcja może zwrócić wartość, która zostanie wpisana do komórki (o ile inne funkcje renderujące wywołane później nie zmienią tej wartości.

Przykład:

Code Block

	js
	js

// Rejestracja renderera
var vss = ServiceFactory.getVariableSetService();
 
vss.addRenderer(vss.get(0), function(value, data, column, metaData){
 
	// nadanie stylu na podstawie wartości zmienna1
	metaData.style = 'color: ' + value; // lub data[column]
 
	// nadanie klasy na podstawie wartości zmienna2
	metaData.cls = data['zmienna2'];
 
	// nadanie nowej wartości
	return 'rendered:' + value;
}), ['zmienna1']); // renderer dla podanej kolumny

columns

String[]

Wszystkie kolumny tabelki

Tablica identyfikatorów zmiennych (kolumn) dla których ma obowiązywać ta funkcja renderująca. Jeżeli pominiemy ten parametr, funkcja będzie obowiązywać dla wszystkich zmiennych.

Rezultat funkcji: brak

removeRenderers (od 3.1.6) - usuwa wszystkie funkcje renderujące z podanej zmiennej tabelki dynamicznej

Parametry funkcji:

Nazwa	Typ	Wartość domyślna	Opis
variableSet	Suncode.form.view.gadget.variableset.VariableSet	null	Komponent tabelki dynamicznej
columns	String[]	Wszystkie kolumny tabelki	Tablica identyfikatorów zmiennych (kolumn) z których usunąć wszystkie funkcje renderujące.

Rezultat funkcji: brak

selectAll (od 3.1.8) - zaznacza wszystkie rekordy z tabeli dynamicznej (uwaga: wiąże się to z dodaniem do każdego rekordu określonej klasy css, rekordy nie są zwracane przez selModel.getSelection()).
- Parametry funkcji:
  
  Nazwa Typ
  Wartość domyślna
  Opis
  variableSet Suncode.form.view.gadget.variableset.VariableSet null Komponent tabeli dynamicznej
- Rezultat funkcji: brak
deselectAll (od 3.1.8) - odznacza wszystkie rekordy z tabeli dynamicznej (uwaga: wiąże się to z usunięciem z każdego rekordu określonej klasy css).
- Parametry funkcji:
  
  Nazwa Typ
  Wartość domyślna
  Opis
  variableSet Suncode.form.view.gadget.variableset.VariableSet null Komponent tabeli dynamicznej
- Rezultat funkcji: brak
getAllSelected (od 3.1.8) - zwraca wszystkie zaznaczone rekordy (za pomocą funkcji selectAll, czyli posiadające określona klasę css).
- Parametry funkcji:
  
  Nazwa Typ
  Wartość domyślna
  Opis
  variableSet Suncode.form.view.gadget.variableset.VariableSet null Komponent tabeli dynamicznej
- Rezultat funkcji:
  
  Typ Opis
  Ext.data.Model[] Tablica zaznaczonych rekordów
minimize (od 3.1.25) - minimalizuje tabelę dynamiczną.
- Parametry funkcji:
  
  Nazwa Typ
  Wartość domyślna
  Opis
  variableSet Suncode.form.view.gadget.variableset.VariableSet null Komponent tabeli dynamicznej
- Rezultat funkcji: brak

...

Versions Compared

Old Version 44

New Version 45

Key