DEFRIBBONBAR

DesktopResponsive

Consente di definire una Ribbon Bar.

Parametri

Parametro	Definizione	I/O		Versione traduttore	SMP
NOME	Intero
IDRIBBONBAR	Stringa
IDEVENTO	Stringa
FOGLIODISTILE	Stringa
TIPORIBBONBAR	Stringa
CATEGORIA

NOME

InteroInputObbligatorioValore non necessarioDesktopWebMobileResponsive

Consente di specificare il nome del controllo Ribbon Bar.

IDRIBBONBAR

StringaInputObbligatorioValore non necessarioDesktopWebMobileResponsive

Consente di specificare l'identificatore univoco della Ribbon Bar.

Lo stesso va referenziato nel parametro RIBBON della specifica @DEFVID per associare la Ribbon Bar alla videata.

IDEVENTO

StringaReferenzaValore non necessarioDesktop

Consente di identificare il tasto della Ribbon Bar premuto.

La variabile viene valorizzata con l'identificativo del tasto.

note

Va utilizzato SOLO nel caso in cui si debba introdurre la Ribbon Bar senza portare le azioni da eseguire direttamente nelle Callback dei bottoni.
Non è quindi utilizzabile con il modello di sviluppo MVC dove per definizione l'esecuzione delle azioni avviene senza uscire dalla videata.

suggerimento

In ottica di sorgenti separati è possibile utilizzare la funzione @GETLASTRIBBONEVENT

FOGLIODISTILE

StringaInputValore non necessarioDesktopWebMobileResponsive

Consente di specificare il nome del foglio di stile da utilizzare.

note

Deve contenere anche l'estensione ('.SXVS').

TIPORIBBONBAR

StringaInputValore non necessarioDesktop

Consente di specificare qual è il tipo della Ribbon Bar, tra quelli definiti sul foglio di stile, da utilizzare.

Se non indicato, si assume come valore di default quanto indicato nel parametro IDRIBBONBAR.

note

Eventuali bottoni non esplicitamente definiti nell'elemento indicato vengono ricercati nell'elemento di default identificato dall'Id='*'.

CATEGORIA

InputObbligatorioRipetibileValore non necessarioDesktopWebMobileResponsive

SottoParametri

Consente di definire una categoria della Ribbon Bar.

note

Può essere ripetuto in base al numero di categorie da prevedere.

warning

Non è possibile definire una Ribbon Bar senza almeno una categoria.

suggerimento

L'ambiente, automaticamente, va ad inserire, come ultima categoria della RibbonBar la categoria 'Help'. In tale categoria saranno presenti tutte le funzionalità collocate all'interno del menu di contesto di sistema, dandogli una maggiore rilevanza: Help, Richiesta di assistenza, Note utente, ecc... E' possibile implementare tale categoria con operazioni di prodotto (Es. Tutorial videata), definendo una categoria specifica con l'identificativo: 'SYSTEM_CATEGORY' All'interno della categoria di 'Sistema', verranno inseriti prima Gruppi e Bottoni di sistema, successivamente gruppi e bottoni di prodotto.

Metodi

Metodo	Descrizione	SMP
GetRicercaHelpValore	Reperisce il valore contenuto nel campo di ricerca della ribbon.
RicercaHelpSetFocus	Forza il fuoco sul campo di ricerca della ribbon

Esempi

Definizione di una ribbon bar con pulsante switch

 '@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata1_2"] NOME[VideataEsempio1_2] RIBBON[IDRIBBON["IDRibbonEsempio1_2"]]
 
    '@DEFRIBBONBAR NOME[Esempio1_2] IDRIBBONBAR["IDRibbonEsempio1_2"] _
                   CATEGORIA[ID["IDCategoria"] TIT["Azioni"] _
                             GRUPPO[ID["Grupppo1"] TIT["Navigazione"] _
                                    BOTTONE[ID["SYS_EXIT"] TIT["Abbandona"] AZIONE[Abbandona()]] _
                                    BOTTONE[ID["BTN_SWITCH"] TIT["Switch"] TIPO[#SWITCH_BUTTON] VALORE[1]] _
                             ] _
                   ]   
                   
 '@RUNVID

Gestione dello stato di un pulsante switch su ribbon bar

 DIM stato[INT] = 1
 DIM stato2[INT] 

 '@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata2_1"] NOME[VideataEsempio2_1] RIBBON[IDRIBBON["IDRibbonEsempio2_1"]]
 
    '@DEFRIBBONBAR NOME[Esempio2_1] IDRIBBONBAR["IDRibbonEsempio2_1"] _
                   CATEGORIA[ID["IDCategoria"] TIT["Azioni"] _
                             GRUPPO[ID["Grupppo1"] TIT["Navigazione"] _
                                    BOTTONE[ID["SYS_EXIT"] TIT["Abbandona"] AZIONE[Abbandona()]] _
                                    BOTTONE[ID["BTN_SWITCH"] TIT["Switch"] TIPO[#SWITCH_BUTTON] VALORE[stato] AZIONE[PrendiStato(stato)]] _
                             ] _
                   ]
                   
    '@DEFGRIDPANEL NOME[GridPanel_1] ID["IDGridPanel_1"] POS[1,1] DIM[13,42] _
                   COLONNA[LUNGHEZZA[0.2] LAYOUT[FISSO]] _
                   COLONNA[LUNGHEZZA[10] LAYOUT[DINAMICO]] _
                   COLONNA[LUNGHEZZA[0.2] LAYOUT[FISSO]] _
                   COLONNA[LUNGHEZZA[10] LAYOUT[DINAMICO]] _
                   RIGA[ALTEZZA[0.2] LAYOUT[FISSO]] _
                   RIGA[ALTEZZA[1] LAYOUT[DINAMICO]] _
                   RIGA[ALTEZZA[1] LAYOUT[DINAMICO]] _
                   
       '@DEFEDIT  ID["Edit_Status"] VAR[stato] POS[1,1] DIM[1,10] RET[2,1] FMT[NUMERICO[7]] GRID[RIGA[2] COL[2]]
       
       '@DEFEDIT  ID["Edit_Status2"] VAR[stato2] POS[1,1] DIM[1,10] RET[2,1] FMT[NUMERICO[7]] GRID[RIGA[3] COL[2]]

       '@DEFBUTTON  DIM[1,10] POS[1,1] ID["BtnGetStatus"] VAR["Prendi Stato"] GRID[RIGA[3] COL[4]] AZIONE[PrendiStato2(stato2)] CONVARIABILI[1]

    
    '@ENDGRIDPANEL NOME[GridPanel_1]    
    
 '@RUNVID

... 
'@SRP PrendiStato(stato[INT] [IN]) 

    stato = GETRIBBONBUTTONSTATE(VideataEsempio2_1.GetIdRuntime(),"BTN_SWITCH")
    '@RESETVID VID[VideataEsempio2_1.GetIdRuntime()] ID["Edit_Status"]    

Return

... 
'@SRP PrendiStato2(stato2[INT] [IN]) 

    stato2 = GETRIBBONBUTTONSTATE(VideataEsempio2_1.GetIdRuntime(),"BTN_SWITCH")
    '@RESETVID VID[VideataEsempio2_1.GetIdRuntime()] ID["Edit_Status2"]    

Return

Gestione dello stato di un pulsante switch su ribbon bar in multi pagina

 DIM stato[INT] = 1

 '@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata2_2"] NOME[VideataEsempio2_2] RIBBON[IDRIBBON["IDRibbonEsempio2_2"]]
 
    '@DEFRIBBONBAR NOME[Esempio2_2] IDRIBBONBAR["IDRibbonEsempio2_2"] _
                   CATEGORIA[ID["IDCategoria"] TIT["Azioni"] _
                             GRUPPO[ID["Grupppo1"] TIT["Navigazione"] _
                                    BOTTONE[ID["SYS_EXIT"] TIT["Abbandona"] AZIONE[Abbandona()]] _
                                    BOTTONE[ID["BTN_SWITCH"] TIT["Switch"] TIPO[#SWITCH_BUTTON] VALORE[stato] AZIONE[PrStato(stato)]] _
                             ] _
                   ]
                   
    '@DEFVIDMPAG TIT["Pagina1"] ID["Nodo_1"] GES[Finestra1()] _
                 TIT["Pagina2"] ID["Nodo_2"] GES[Finestra2()] _
                 SELETTORE[TIPO[#VERTICALE] DIM[20] ASSEGNAFUOCO[1]]                   
    
 '@RUNVID

... 
 'Nella sub richiamata dal multipagina
 DIM stato[INT]

  '@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideataMultiPagina"] NOME[VideataMultiPag] RIBBON[IDRIBBON["IDRibbonMulti"]]
 
    '@DEFRIBBONBUTTON NOME[BottoneSwitch] ID["BTN_SWITCH"] AZIONE[PrStato(stato)]
 
 '@RUNVID

... 
'@SRP PrStato(stato[INT] [IN]) 
 
    stato = GETRIBBONBUTTONSTATE(VideataEsempio2_1.GetIdRuntime(),"BTN_SWITCH")
    '@RESETVID VID[VideataEsempio2_1.GetIdRuntime()] ID["Edit_Status"]      

Return

Ridefinizione di un bottone con menù contestuale

 '@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata3"] NOME[VideataEsempio3] RIBBON[IDRIBBON["IDRibbonEsempio3"]]
 
    '@DEFCONTEXTMENU IDMENU["MENU_CONTEXT"] _
                     TITOLO["Titolo 1"]     _
                     TITOLO["Titolo 2"]
                     
    '@DEFRIBBONBAR NOME[Esempio2] IDRIBBONBAR["IDRibbonEsempio2"] _
                   CATEGORIA[ID["IDCategoria"] TIT["Azioni"] _
                             GRUPPO[ID["Grupppo1"] TIT["Navigazione"] _
                                    BOTTONE[ID["SYS_EXIT"] TIT["Abbandona"] AZIONE[Abbandona()]] _
                                    BOTTONE[ID["BTN_MENU"] TIT["Nuove azioni"] AZIONE[MENU["MENU_CONTEXT"]]] _
                               ] _
                   ]
 
 '@RUNVID

... 
 ' Sorgente in cui è necessario utilizzare il bottone

 ' Definizione del menù contestuale, comprese le azioni
 '@DEFCONTEXTMENU IDMENU["MENU_CONTEXT"]                   _
                  TITOLO["Titolo 1"] AZIONE[Azione1()] _
                  TITOLO["Titolo 2"] AZIONE[Azione2()]

 ' Ridefinizione del bottone della ribbon bar
 '@DEFRIBBONBUTTON NOME[btnMenu] ID["BTN_MENU"] AZIONE[MENU["MENU_CONTEXT"]]