B-Arts DocumentationIndice generale

BFrameworkControls - domande degli sviluppatori

Le risposte rimandano alle schede API complete. Gli esempi sono intenzionalmente limitati: prima di generare codice verificare sempre proprietà, eventi, metodi e overload nella scheda del tipo.

BTesto

Quando uso BTesto invece di TextBox?

Usare BTesto quando servono tipi di dato B-Arts, formato, decimali, caption, allineamento, gestione del focus oppure ricerca DB. Un TextBox standard è sufficiente soltanto quando questi comportamenti non servono.

Come gestisco interi, decimali, valuta, data e ora?

Impostare TipoDiDato; per i numeri configurare anche TipoNum, CifreDec, NumDecVisibili e NumDecRound. Nei progetti B-Arts preferire int, double e DateTime.

BTesto può cercare un valore nel database?

Sì. Usare mbeCampoDB e configurare Connection, tabella o stored procedure, comando, campi chiave/descrizione, filtro, ordinamento e proprietà di ricerca documentate.

BCombo

Quali sorgenti può usare BCombo?

Può lavorare con elementi aggiunti al controllo, BItem, DataTable e dati caricati attraverso la connessione e la configurazione DB prevista dalla sua API.

Come recupero il valore selezionato?

Usare le proprietà pubbliche relative a valore, testo e indice selezionato indicate nella scheda BCombo; non leggere direttamente i controlli interni.

Posso aggiungere una voce nulla o personalizzare la ricerca?

Sì, attraverso le proprietà e i metodi pubblici dedicati agli elementi, al valore nullo e alla ricerca. Verificare le firme nella scheda prima di generare il codice.

BCheck

BCheck gestisce anche tre stati?

Sì. Espone ThreeState, CheckState, Checked e le configurazioni testuali o visuali del controllo.

Posso rappresentare gli stati con testo oppure immagini?

Sì. CheckStyle, CheckType, Text1, Text2, Image1 e Image2 controllano la rappresentazione.

Come intercetto il cambio di valore?

Collegare l'evento pubblico CheckChanged usando la firma del delegate riportata nella scheda.

BCasellaDB

A cosa serve BCasellaDB?

Serve a selezionare una chiave proveniente dal database mostrando la relativa descrizione, senza ricostruire manualmente ricerca e visualizzazione chiave/descrizione.

Posso usare una tabella o una stored procedure?

Sì. Configurare NomeTabella oppure NomeStoredProcedure, TipoComando, Connection e i campi indicati nella scheda.

Come scelgo fra chiave numerica e testuale?

Impostare TipoDatoKey e mantenere coerenti CampoKey, FormatoKey e il valore assegnato al controllo.

BBarraDati

Quali operazioni coordina?

Navigazione, nuovo record, salvataggio, annullamento, eliminazione, aggiornamento, ricerca, stampa e uscita, oltre agli stati nuovo/visione/modifica.

Qual è la differenza fra salvataggio interno ed esterno?

Con INTERNO la barra usa connessione, BDataTable, query e chiavi; con ESTERNO delega persistenza ed eliminazione agli eventi EST_SalvaRecord ed EST_EliminaRecord.

Come sincronizzo form e record corrente?

Gestire CambiaRec per mostrare la riga e ScriviRec per trasferire i valori della form nella riga. Considerare i parametri ByRef nelle firme provenienti da Visual Basic.

BGriglia

Cosa aggiunge rispetto a DataGridView?

Configurazione B-Arts delle colonne, tipi logici, formati, obbligatorietà, elenchi, ricerca, gestione degli eventi protetti e operazioni di lettura e scrittura documentate nella sua API.

Come definisco le colonne?

Usare MBGrigliaColonna; per una colonna elenco o ricerca usare anche MBGrigliaCampoElenco. Questi modelli sono utilizzabili sia dal designer sia a runtime.

Come valido o intercetto la modifica delle celle?

BView

Quando uso BView invece di BGriglia?

Usare BView quando serve una DataGridView B-Arts di livello più basso, con lettura, scrittura, inserimento, eliminazione e gestione del focus, senza tutta la configurazione di BGriglia.

Come leggo o scrivo una cella?

Usare ReadCell e WriteCell con riga e colonna secondo le firme documentate.

Posso gestire automaticamente inserimento ed eliminazione?

Sì. Sono disponibili AddRow, DeleteRow, AutoDeleteRow, ShowQuestionBeforeDelete e gli eventi precedenti e successivi all'eliminazione.

BRicerca

Quali tipi di ricerca supporta?

La scheda documenta le modalità semplice, completa e dettagliata, insieme alle proprietà per colonne, criteri, connessione e risultati.

Come definisco le colonne ricercabili e restituite?

Usare MBColSearch e le configurazioni esposte da BRicerca, distinguendo colonne visive, ordinate, composte e restituite.

Come recupero i risultati?

Usare i metodi, le proprietà e gli eventi pubblici di BRicerca riportati nella scheda, mantenendo separati criteri di ricerca e dati restituiti.

BMenu

Come viene costruito il menu?

BMenu costruisce gruppi e comandi a partire dalla struttura dati prevista dalla propria API, invece di richiedere la creazione manuale di ogni voce WinForms.

Come intercetto la selezione di un comando?

Collegare l'evento pubblico dedicato e usare esattamente la firma del relativo delegate indicata nella scheda.

Posso controllare stile e disposizione del menu?

Sì, tramite le proprietà pubbliche di aspetto, dimensionamento e comportamento documentate. Le modifiche puramente grafiche statiche possono restare nel designer.

Tipi design-time

Devo usare MBEditor o FrmEditor nella UI dell'applicazione?

No. Sono strumenti destinati alla finestra Proprietà e al designer di Visual Studio.

MBGrigliaColonna e MBGrigliaCampoElenco sono utilizzabili a runtime?

Sì. Sono modelli pubblici di configurazione, non finestre applicative.

Posso modificare direttamente i file Designer?

Non per introdurre logica applicativa. Gli eventi e la configurazione dinamica vanno inseriti nel code-behind della form, preservando i file generati dal designer.