button — u_pbt_button #

← Riferimento dei componenti · Sommario della guida

Pulsante a tema: testo e icona, stili, badge contatore, scorciatoia da tastiera, pulsanti predefinito e di annullamento.

⚠️ Più pulsanti? Preferisci buttonbar: una fila in un solo componente, dove N button separati costano N volte la memoria (ogni componente è una vista del motore). button resta supportato per il codice esistente.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro Button: l'anteprima, il codice che lo produce e questa pagina, affiancati.

In breve #

Avvio rapido #

// event open della finestra
uo_button.is_text  = "&Salva"                // & = lettera sottolineata : Alt+S lo attiva
uo_button.is_style = uo_button.STYLE_PRIMARY // pulsante dell'azione principale
uo_button.is_image = "mono:img\save.svg"     // icona ricolorata dal tema
uo_button.is_shortcut = "Ctrl+S"             // scorciatoia mostrata e attiva
uo_button.is_tooltip = "Salva la pratica corrente"

// event ue_clicked di uo_button
of_save()

Costanti #

Proprietà #

Metodi #

Event #

Esempi #

I tre stili #

// Il pulsante principale : risponde al tasto Invio
uo_ok.is_text     = "Conferma"
uo_ok.is_style    = uo_ok.STYLE_PRIMARY
uo_ok.ib_default  = true          // tasto Invio

// Il pulsante di annullamento : risponde al tasto Esc
uo_cancel.is_text   = "Annulla"
uo_cancel.is_style  = uo_cancel.STYLE_STANDARD
uo_cancel.ib_cancel = true       // tasto Esc

// Un pulsante di aiuto discreto
uo_help.is_text  = "Guida"
uo_help.is_style = uo_help.STYLE_FLAT   // discreto, senza bordo

Icona e badge di notifica #

// Un'icona piu grande e un badge contatore
uo_messages.is_text  = "Messaggi"
uo_messages.is_image = "mono:img\mail.svg"
uo_messages.ii_image_size = 20
uo_messages.ii_badge = 12             // badge "12"

// Aggiornare il contatore: il badge scompare a 0
uo_messages.ii_badge = ll_unread

// Un badge rosso per un avviso, invece del colore del tema.
// Il colore del testo viene scelto da solo per restare leggibile.
uo_messages.il_badge_color = RGB(/*red*/ 200, /*green*/ 30, /*blue*/ 30)

// Tornare al colore che proviene dal tema
uo_messages.il_badge_color = -1

Etichetta arricchita #

// Testo ricco : grassetto e dimensione ridotta, o un'immagine nel testo
uo_button.is_text = "[b]Esporta[/b] [size-=20]· CSV[/size-=20]"
uo_button.is_text = "Stato [picture=mono:img\ok.svg,14,14]"

Pulsante dell'azione principale con scorciatoia e aiuto #

// Bloccare il disegno durante le impostazioni
uo_submit.of_set_redraw(/*on*/ false)

// Testo, stile, scorciatoia, pulsante predefinito e tooltip ricco
uo_submit.is_text     = "&Conferma l'ordine"
uo_submit.is_style    = uo_submit.STYLE_PRIMARY
uo_submit.is_shortcut = "Ctrl+Enter"
uo_submit.ib_default  = true
uo_submit.is_super_tooltip_title = "Conferma"
uo_submit.is_super_tooltip_text  = "Invia l'ordine al fornitore." &
                                    + "[br][br][size-=15]Azione irreversibile.[/size-=15]"

// Un solo ridisegno, con tutto
uo_submit.of_set_redraw(/*on*/ true)

Reagire al passaggio del mouse #

// Raise ue_mouse_enter and ue_mouse_leave when the pointer comes and goes
uo_button.ib_track_mouse = true

// event ue_mouse_enter di uo_button
uo_status.of_panel(/*key*/ "main").is_text = "Salva la pratica corrente"

Buone pratiche #

• Un solo pulsante primary per schermata: è l'azione attesa.
• ib_default e ib_cancel sostituiscono la gestione manuale di Invio / Esc nella sua finestra.
• Utilizzi mono: per le icone monocromatiche: seguiranno sia il tema chiaro sia quello scuro.
• Chiami of_reset() prima di riutilizzare un pulsante per un'altra azione.

Ereditato dalla base comune #

Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.

Due aiuti non sono ereditati: of_icon e of_escape_markup vivono su n_pbt_utils. Ne dichiari uno — n_pbt_utils lnv_utils, niente da creare — e li chiami su di esso.

← Riferimento dei componenti · Sommario della guida