Zestaw dostępnych Triggerów

QBS >> Suplementy i dokumentacja techniczna >> Zestaw dostępnych Triggerów

BROWSER

BeforeModifyTrigger - Zdarzenie wołane przed modyfikacją rekordu, po naciśnieciu M.
- Pakiet - qline.browser
- Selector
  - ```
  public BeforeModifyTriggerSelector(String receditDefName)
```
  - String receditDefName - podajemy identyfikator tab'a edycji rekordu dla którego ma być wywołane to zdarzenie (null - zawsze).
- ```
public BeforeModifyTriggerSelector(String receditDefName,int type)
```
    - String receditDefName - podajemy identyfikator tab'a edycji rekordu dla którego ma być wywołane to zdarzenie (null - zawsze).
    - int type - rozdaj pierwszego parametru:
      - SELECTOR_TYPE_TABDEFNAME - nazwa tabdefa;
      - SELECTOR_TYPE_TABDEFPREFIX - prefiks tabdefa;
      - SELECTOR_TYPE_BASENAME - nazwa tabeli bazowej;
- Plugin
```
public BeforeModifyTriggerResult runBeforeModifyRecord(Transaction tr,
                                                       RecordEditTabDefBlock retdb,
                                                       ReadOnlyRecord record,
                                                       Window parentw)
```
  - Transaction tr - transakcja w której będzie modyfikowany rekord!
  - RecordEditTabDefBlock retdb - Opis EDIT TAB'a
  - ReadOnlyRecord record - modyfikowany record
  - Window parentw - Okno nadrzędne - (uwaga nie musi to być BrowserWindow!)
- Result
```
public BeforeModifyTriggerResult(boolean domodify)
```
  - domodify - czy modyfikować rekord
BeforeDeleteTrigger - Zdarzenie wołane przed skasownaiem rekordu, po zadaniu pytania, tylko w przypadku gdy odpowiedź była "TAK"
- Pakiet - qline.browser
- Selector
  - ```
  public BeforeDeleteTriggerSelector(String receditDefName)
```
  - String receditDefName - podajemy identyfikator tab'a edycji rekordu dla którego ma być wywołane to zdarzenie (null - zawsze).
- ```
public BeforeDeleteTriggerSelector(String receditDefName,int type)
```
    - String receditDefName - podajemy identyfikator tab'a edycji rekordu dla którego ma być wywołane to zdarzenie (null - zawsze).
    - int type - rozdaj pierwszego parametru:
      - SELECTOR_TYPE_TABDEFNAME - nazwa tabdefa;
      - SELECTOR_TYPE_TABDEFPREFIX - prefiks tabdefa;
      - SELECTOR_TYPE_BASENAME - nazwa tabeli bazowej;
- Plugin
```
public BeforeDeleteTriggerResult runBeforeDeleteRecord(Transaction tr,
                                                       RecordEditTabDefBlock retdb,
                                                       ReadOnlyRecord record,
                                                       Window parentw)
```
  - Transaction tr - transakcja w której będzie kasowany rekord!
  - RecordEditTabDefBlock retdb - Opis EDIT TAB'a
  - ReadOnlyRecord record - kasowany record
  - Window parentw - Okno nadrzędne - (uwaga nie musi to być BrowserWindow!)
- Result
```
public BeforeDeleteTriggerResult(boolean dodelete)
```
  - dodelete - czy skasować rekord
QCON
ColumnActionTrigger - Czytanie z plików *.qcon własnych akcji menu i ich parametrów (kolumna ACTION)
- Pakiet - qline.config
- Selector
```
public ColumnActionTriggerSelector(String actionId)
```
  - String actionId - podajemy identyfikator akcji (null - zawsze).
- Plugin
```
public ColumnActionTriggerResult readActionParams(String actionident,
                                                  Tokenizer tokenizer)
```
  - String actionident - identyfikator akcji
  - Tokenizer tokenizer - Tokenizer do wczytania parametrów (jak nie chcemy żadnych parametrów to nie ruszamy tokenizera, id akcji jest już wczytane oczywiście!)
- Result
  - ```
  public ColumnActionTriggerResult(Object params)
```
  - params - zbudowany obiekt parametrów (może być null'em ja nie mamy parametrów)
- ```
public ColumnActionTriggerResult(Object params,MenuActionMark mark)
```
    - params - zbudowany obiekt parametrów (może być null'em ja nie mamy parametrów)
    - mark - piktogram do pokazania w menu z prawej strony.
RunMenuActionTrigger - zdarzenie wołane podczas wybrania pozycji menu. (Tu się podkłada uruchomienie własnej akcji)
- Pakiet - qline.menu
- Selector
```
RunMenuActionTriggerSelector(String actionId)
```
  - String actionId - podajemy identyfikator akcji (null - zawsze).
- Plugin
```
public RunMenuActionTriggerResult runMenuAction(String actionId,
                                                Object params,
                                                ModalParent mp,
                                                Window parentWindow)
```
  - String actionId - identyfikator akcji
  - Object params - zaczytane parametry z *.qcon
  - ModalParent mp - ModalParent
  - Window parentw - Okno nadrzędne - (uwaga nie musi to być okno MenuWindow!). Dla menu wołanym z browsera tym oknem będzie BrowserWindow.
- Result
```
public RunMenuActionTriggerResult(boolean cont)
```
  - cont - czy wykonać standardową obsługę. Dostępne są statyczne stałe RunMenuActionTriggerResult.RESULT_FALSE, by nie tworzyć obiektów za każdym razem
ColumnMaskTrigger - Czytanie z plików *.qcon własnych definicji masek i ich parametrów (kolumna MASK)
- Pakiet - qline.config
- Selector
```
ColumnMaskTriggerSelector(String maskId)
```
  - String maskId - podajemy identyfikator maski (null - zawsze).
- Plugin
```
public ColumnMaskTriggerResult readMaskParams(String maskident,
                                              Tokenizer tokenizer)
```
  - String maskident - identyfikator maski
  - Tokenizer tokenizer - Tokenizer do wczytania parametrów (jak nie chcemy żadnych parametrów to nie ruszamy tokenizera, id akcji jest już wczytane oczywiście!)
- Result
```
public ColumnMaskTriggerResult(Object params)
```
  - params - zbudowany obiekt parametrów (może być null'em ja nie mamy parametrów)

CreateControlTrigger - zdarzenie wołane podczas tworzenia kontrolki (tu wstawiamy własne kontrolki)

Pakiet - qline.recordedit

Selector

public CreateControlTriggerSelector(int mask)

mask - intid maski

public CreateControlTriggerSelector(String tabdefName, String fieldId)

tabdefName - nazwa TAB edycji
fieldId - id pola

public CreateControlTriggerSelector(int mask,String tabdefName, String fieldId)

mask - intid maski
tabdefName - nazwa TAB edycji
fieldId - id pola

Plugin

public CreateControlTriggerResult createControl(Param controlParam,
                                                String fieldId,
                                                int mask,
                                                FieldControlManager fldmgr)

Param controlParam - Parametr na którym mamy zbudować kontrolkę
String fieldId - identyfikator pola
int mask - intid maski
FieldControlManager fldmgr - FieldControlManager

Result
- ```
public CreateControlTriggerResult(FieldControl control,Component comp)
```
  - control - FieldControl
  - component - component do dodania do drzewa scm
- ```
CreateControlTriggerResult(FieldControl control)
```
  - control - FieldControl, jest on też komponentem

RECORD

BeforeEditRecordTrigger - Zdarzenie wołane bezpośrednio przed edycją recordu.
- Pakiet - qline.recordedit
- Selector
  - ```
  public BeforeEditRecordTriggerSelector(String receditDefName)
```
  - String receditDefName - podajemy identyfikator tab'a edycji rekordu dla którego ma być wywołane to zdarzenie (null - zawsze).
- ```
public BeforeEditRecordTriggerSelector(String receditDefName,int type)
```
    - String receditDefName - podajemy identyfikator tab'a edycji rekordu dla którego ma być wywołane to zdarzenie (null - zawsze).
    - int type - rozdaj pierwszego parametru:
      - SELECTOR_TYPE_TABDEFNAME - nazwa tabdefa;
      - SELECTOR_TYPE_TABDEFPREFIX - prefiks tabdefa;
      - SELECTOR_TYPE_BASENAME - nazwa tabeli bazowej;
- Plugin
```
public BeforeEditRecordTriggerResult runBeforeEditRecord( RecordEditRecordManager recMgr, FieldControlManager fldmgr )
```
  - RecordEditRecordManager recMgr - manager recordu
  - FieldControlManager fldmgr - manager pól recordu
- Result
```
public BeforeEditRecordTriggerResult()
```
AfterEditRecordTrigger - zdarzenie wołane po akceptacji rekordu (F10)
- Pakiet - qline.recordedit
- Selector
```
    public AfterEditRecordTriggerSelector(String tabdefName)
```
  - String tabdefName - podajemy identyfikator TAB opisującego edycję rekordu (null - zawsze).
- Plugin
```
public AfterEditRecordTriggerResult runAfterEditRecord(RecordEditRecordManager recMgr,
                                                       FieldControlManager fldmgr)
```
  - RecordEditRecordManager recMgr - RecordEditRecordManager
  - FieldControlManager fldmgr - FieldControlManager
- Result
  - ```
  public AfterEditRecordTriggerResult(boolean proceed)
```
  - proceed - czy pozwolić na akceptację rekordu.
- ```
public AfterEditRecordTriggerResult(boolean proceed, boolean acceptTrans,boolean runTriggers)
```
    - proceed - czy pozwolić na akceptację rekordu.
    - acceptTrans - czy akceptować transakcję
    - runTriggers - kontynuować obsługę triggerów podpiętych pod to zdarzenie
THTML

THTMLInitPrinterTrigger - zdarzenie wołane podczas inicjowania generatora THTML - do podłączania swoich poleceń i innych

Pakiet - qline.thtml

Selector

public THTMLInitPrinterTriggerSelector()

Plugin

public THTMLInitPrinterTriggerResult createTHTMLExecutors(String src,
                                                          String dst,
                                                          ReadOnlyRecord vars,
                                                          Transaction tr)

String src - plik źródłowy
String dst - plik docelowy
ReadOnlyRecord vars - record zmiennych globalnych
Transaction tr - Transakcja w której jest robiony wydruk

Result

public THTMLInitPrinterTriggerResult(THTMLBuilder builder,THTMLEvaluator evaluator)

builder - builder do drzew THTML
evaluator - evaluator do drzew THTML

BROWSER

QCON

RECORD

THTML