Moduli e componenti
A colpo d'occhio
- Comprendi come interagiscono proprietà, eventi e metodi dei componenti.
- Impara ad aggiungere componenti e a configurare i gestori di eventi utilizzando i pannelli Tool Palette e Object Inspector.
- Esplora esempi per visualizzare form modali, verificare la presenza di campi di input vuoti e controllare il comportamento dei form.
Panoramica dei componenti grafici
Il sistema di scripting gestisce due tipi di componenti: visivi e non visivi.
I componenti visivi vengono utilizzati per creare l'interfaccia utente, mentre quelli non visivi vengono utilizzati per diverse attività, come i componenti Timer, OpenDialog e MainMenu.
-
Il componente non visivo
Timerpuò essere utilizzato per eseguire codice specifico a intervalli prestabiliti e non è mai visibile all'utente. -
I componenti
Button,EditeMemosono componenti visivi.
Entrambi i tipi di componenti sono visibili in fase di progettazione, ma i componenti non visivi non sono visibili durante l'esecuzione. I componenti del pannello Tool Palette sono orientati agli oggetti e presentano i tre elementi seguenti:
- Proprietà
- Eventi
- Metodi
Una Property è una caratteristica di un oggetto che ne influenza il comportamento visibile o le operazioni. Ad esempio, la proprietà Visible determina se un oggetto è visibile o meno in un modulo di script.
Un Event è un'azione o un accadimento rilevato dallo script. In uno script, il programmatore scrive il codice per ciascun gestore di eventi progettato per intercettare un evento specifico, come un clic del mouse.
Un Method è una procedura sempre associata a un oggetto, di cui definisce il comportamento.
Tutti i moduli di script hanno uno o più componenti. I componenti in genere visualizzano informazioni o consentono all'utente di eseguire un'azione. Ad esempio, un Label viene utilizzato per visualizzare testo statico, una casella Edit consente all'utente di inserire dati e un Button può essere utilizzato per avviare azioni.
In un modulo è possibile inserire qualsiasi combinazione di componenti e, durante l'esecuzione dello script, l'utente può interagire con qualsiasi componente del modulo. Spetta al programmatore decidere cosa accade quando l'utente fa clic su un pulsante o modifica il testo in una casella Edit.
Il sistema di scripting fornisce una serie di componenti che possono essere utilizzati per creare interfacce utente complesse per gli script. Per inserire un componente in un modulo, individuarne l'icona nel pannello Tool Palette e fare doppio clic su di essa. Questa azione inserisce un componente nel modulo attivo. L'aspetto della maggior parte dei componenti viene impostato tramite le relative proprietà. Un componente viene inizialmente inserito in una posizione predefinita del modulo, ma può essere riposizionato (trascinandolo) e ridimensionato (allungandolo) secondo necessità. È possibile modificarne le dimensioni e la posizione anche in seguito, utilizzando il pannello Object Inspector.
Quando un componente viene rilasciato su un modulo, il sistema di scripting genera automaticamente il codice necessario per utilizzarlo e aggiorna il modulo di script. Per far funzionare il componente nel modulo, è sufficiente impostarne le proprietà e implementare il codice dei gestori di eventi che utilizza i metodi desiderati.
Progettazione dei moduli di script
Un modulo di script è progettato per interagire con l'utente all'interno dell'ambiente. La progettazione dei moduli di script è il fulcro dello sviluppo visuale.
In pratica, tutti i componenti vengono inseriti in un modulo di script e ogni proprietà impostata viene memorizzata in un file che descrive il modulo (un file *.DFM), collegato al codice di script associato (il file *.PAS). Per ogni modulo di script esistono un file .PAS e il corrispondente file .DFM.
Quando si lavora con un modulo di script e i suoi componenti, tutte le proprietà degli elementi possono essere esaminate e modificate tramite il pannello Object Inspector. È possibile selezionare più componenti facendo clic su di essi mentre si tiene premuto Maiusc oppure trascinando un rettangolo di selezione attorno ai componenti nel modulo. Un modulo di script ha un titolo (la proprietà Caption nel pannello Object Inspector).
Creazione di un nuovo modulo di script
Con un progetto di script aperto, fare clic con il pulsante destro del mouse su un progetto nel pannello Projects, fare clic sulla voce Add New to Project nel menu contestuale e scegliere una voce Delphi Script Form. Si aprirà un nuovo modulo di script con il nome predefinito EditScript1.pas.
Visualizzazione di un modulo di script
Uno script deve avere una procedura che visualizzi il modulo quando il modulo di script viene eseguito. All'interno di questa procedura è possibile richiamare il metodo ShowModal per il modulo. La proprietà Visible del modulo deve essere impostata su false affinché il metodo ShowModal del modulo di script funzioni correttamente.
ShowModal example:
Procedure RunDialog;
Begin
DialogForm.ShowModal;
End;
L'esempio ShowModal mostra un approccio molto semplice per visualizzare il modulo di script quando viene richiamata la procedura RunDialog. Si noti che è possibile assegnare valori ai componenti dell'oggetto DialogForm prima che venga richiamato il metodo DialogForm.ShowModal.
L'esempio della proprietà ModalResult riportato di seguito è leggermente più complesso. I seguenti metodi nello script vengono utilizzati per i pulsanti di un modulo di script. I metodi fanno sì che la finestra di dialogo si chiuda quando l'utente fa clic sul pulsante OK o Cancel, restituendo rispettivamente mrOk o mrCancel dal metodo ShowModal.
ModalResult Example:
Procedure TForm.OKButtonClick(Sender: TObject);
Begin
ModalResult := mrOK;
End;
Procedure TForm.CancelButtonClick(Sender: TObject);
Begin
ModalResult := mrCancel;
End;
Procedure RunShowModalExample;
Begin
// Form's Visible property must be false for ShowModal to work correctly.
If Form.ShowModal = mrOk Then ShowMessage('mrOk');
If Form.ShowModal = mrCancel Then ShowMessage('mrCancel');
End;
Quando l'utente fa clic su uno dei due pulsanti di questo modulo di script, la finestra di dialogo si chiude. Non è necessario richiamare il metodo Close, perché quando viene impostato il metodo ModalResult, il motore di scripting chiude automaticamente il modulo di script.
Si noti che, se si desidera impostare ModalResult del modulo su Cancel quando l'utente preme il tasto Esc, è necessario utilizzare il pannello Object Inspector per impostare la proprietà Cancel del pulsante Annulla su True, oppure inserire Sender.Cancel := True nel gestore dell'evento CancelButtonClick del pulsante del modulo.
Acquisizione dei dati immessi dall'utente
Uno dei componenti più comuni in grado di accettare dati immessi dall'utente è il componente TEdit. Questo componente dispone di un campo in cui l'utente può digitare una stringa di caratteri. Si noti che esistono altri componenti Delphi, come TMaskEdit, un componente di modifica con una maschera di input memorizzata in una stringa, che controlla o filtra i dati immessi.
L'esempio seguente illustra cosa accade quando l'utente fa clic sul pulsante dopo aver digitato qualcosa nella casella di modifica. Se l'utente non ha digitato nulla nel componente di modifica (lasciandolo vuoto), il gestore di eventi risponde con un messaggio di avviso.
Procedure TScriptForm.ButtonClick(Sender : TObject);
Begin
If Edit1.Text = '' Then
Begin
ShowMessage('Warning - empty input!');
Exit;
End;
// do something else for the input
End;
Si noti che l'utente può spostare il focus di input della finestra di dialogo utilizzando il tasto Tab oppure facendo clic su un altro controllo nel modulo.
Risposta agli eventi
Quando si fa clic su un pulsante di un modulo o su un componente, il sistema di scripting risponde ricevendo una notifica di evento da Altium Designer e richiamando il metodo del gestore di eventi appropriato.
See also
Il progetto HelloWorld nella cartella Scripts\DelphiScript Scripts\General\ della raccolta di script.
Lo script di esempio ShowModal nella cartella Scripts\DelphiScript Scripts\General\ della raccolta di script.
Scrittura dei gestori di eventi
Ogni componente in uno script con modulo dispone di un insieme di nomi di eventi, utilizzati dai gestori di eventi dello script che determinano come lo script reagirà alle azioni dell'utente in Altium Designer. Ad esempio, quando un utente fa clic su un pulsante di un modulo, Altium Designer invia un messaggio allo script e quest'ultimo reagisce al nuovo evento. Se è specificato un gestore per l'evento OnClick di un pulsante, questo viene eseguito.
Il codice che risponde agli eventi è normalmente contenuto nei gestori di eventi DelphiScript e tutti i componenti dispongono di un insieme di eventi ai quali possono reagire. Ad esempio, tutti i componenti su cui è possibile fare clic dispongono di un evento OnClick che viene attivato quando un utente fa clic su un componente. Tutti questi componenti dispongono anche di eventi per l'acquisizione e la perdita del focus. Tuttavia, se il codice per OnEnter e OnExit non è stato specificato (OnEnter - il controllo ha acquisito il focus; OnExit - il controllo ha perso il focus), l'evento verrà ignorato dallo script.
In sintesi, un evento è un collegamento tra un'azione in Altium Designer, come il clic su un pulsante, e una porzione di codice che risponde a tale azione. Il codice che risponde è un gestore di eventi. Questo codice modifica i valori delle proprietà e richiama i metodi.
Proprietà dei componenti
Per visualizzare l'elenco delle proprietà di un componente, selezionare un componente e aprire la scheda Properties nel pannello Object Inspector.
Eventi dei componenti
Per visualizzare l'elenco degli eventi ai quali un componente può reagire, selezionare un componente e aprire la scheda Events nel pannello Object Inspector. Per creare una procedura di gestione di un evento, selezionare l'evento al quale si desidera che il componente reagisca e fare doppio clic sul nome dell'evento: il sistema di scripting inserirà automaticamente la struttura del codice del gestore di eventi.
Ad esempio, selezionare il componente TButton dal pannello Tool Palette e rilasciarlo sul modulo dello script, quindi fare doppio clic accanto al nome dell'evento OnClick nel pannello Object Inspector . Il sistema di scripting porterà il focus sull'editor di codice e creerà la struttura del codice per l'evento OnClick.
Ad esempio, se un pulsante contiene un metodo Close nel gestore dell'evento CloseClick, quando si fa clic sul pulsante il relativo gestore intercetterà l'evento OnClick, causando l'esecuzione del codice al suo interno. Di conseguenza, il metodo Close chiude il modulo dello script.
In sintesi, selezionare un componente pulsante sul modulo o tramite il pannello Object Inspector, selezionare la pagina Events e fare doppio clic sul lato destro dell'evento OnClick: nello script apparirà un nuovo gestore di eventi. In alternativa, fare doppio clic sul pulsante stesso e il sistema di scripting aggiungerà un gestore per questo evento OnClick. Si noti che altri tipi di componenti avranno azioni predefinite diverse.
Metodi dei componenti
Per visualizzare l'elenco dei metodi di un componente, consultare il documento Riferimento dei componenti.
Inserimento di componenti in un modulo dello script
Per utilizzare in uno script i componenti del pannello Tool Palette, è necessario che esista un modulo dello script prima di potervi rilasciare i componenti. Normalmente, quando i componenti vengono rilasciati su un modulo dello script, non è necessario creare o distruggere questi oggetti: il modulo dello script se ne occupa automaticamente.
Il sistema di scripting genera inoltre automaticamente il codice necessario per utilizzare un componente e aggiorna il modulo dello script. A quel punto è sufficiente impostare le proprietà, inserire il codice nei gestori di eventi e utilizzare i metodi necessari per realizzare un modulo dello script funzionante.
Creazione di componenti in uno script
I componenti possono essere creati o distrutti direttamente in uno script passando un parametro Nil al Constructor di un componente. Normalmente non è necessario passare l'handle del modulo, poiché il modulo dello script se ne occupa automaticamente. Ad esempio, è possibile creare e distruggere le finestre di dialogo Open e Save (classi TOpenDialog e TSaveDialog della RTL di Embarcadero Delphi).
Personalizzazione dei moduli degli script
I punti essenziali per personalizzare i moduli degli script sono:
-
Per fare in modo che un modulo rimanga in primo piano rispetto agli altri pannelli aperti, impostare la proprietà
FormStylesufsStayOnTop. -
Per definire il comportamento predefinito di un modulo, impostare
FormKindsu uno dei seguenti valori:fkNone,fkNormal,fkServerPanelofkModal. -
Se
fkModalè chiuso, il modulo sarà modale, ovvero attenderà un intervento dell'utente prima di procedere, ad esempio la chiusura del modulo. SefkServerPanel, il modulo verrà visualizzato come pannello Server. SefkNormal, il modulo si comporterà come un normale modulo non modale. -
Per rimuovere le barre di scorrimento predefinite del modulo, modificare il valore delle proprietà
HorzScrollBareVertScrollBar. -
Per rendere il modulo un frame MDI o un modulo figlio MDI, utilizzare la proprietà
FormStyle. -
Per modificare lo stile del bordo del modulo, utilizzare le proprietà
BorderIconseBorderStyle(i risultati sono visibili in fase di esecuzione). -
Per modificare l'icona del modulo ridotto a icona, utilizzare la proprietà
Icon. -
Per specificare la posizione iniziale di un modulo nella finestra dell'applicazione, utilizzare la proprietà
Position. -
Per specificare lo stato iniziale del modulo (ad esempio, ridotto a icona, ingrandito o normale), utilizzare la proprietà
WindowState. -
Per definire l'area di lavoro del modulo in fase di esecuzione, utilizzare le proprietà
ClientHeighteClientWidth(si noti cheClientHeighteClientWidthrappresentano l'area all'interno del bordo del modulo;HeighteWidthrappresentano l'intera area del modulo). -
Per specificare quale controllo ha il focus iniziale nel modulo in fase di esecuzione, utilizzare la proprietà
ActiveControl. -
Per passare tutti gli eventi della tastiera al modulo, indipendentemente dal controllo selezionato, utilizzare la proprietà
KeyPreview. -
Per specificare un determinato menu, se un modulo contiene più di un menu, utilizzare la proprietà
Menu.
Aggiornamento dei moduli degli script e dei componenti
Quando la superficie di un modulo dello script non è aggiornata, ad esempio perché i controlli non vengono aggiornati o ridisegnati, questi possono apparire bloccati o visualizzati in modo errato. Ciò potrebbe essere dovuto a un'intensa elaborazione in background da parte dello script.
Il metodo Update del modulo dello script e di molti componenti di script del pannello Tool Palette consente di aggiornare il contenuto grafico del modulo o dei controlli specifici. Le righe contenenti il metodo Update sono evidenziate in grigio nell'esempio seguente.
StatusBar component and its Update method Example:
Procedure TConverterForm.loadbuttonClick(Sender: TObject);
Begin
If OpenPictureDialog1.Execute then
Begin
XPProgressBar1.Position := 0;
XStatusBar1.SimpleText := ' Loading...';
XStatusBar1.Update;
// loading a monochrome bitmap only
Image1.Picture.LoadFromFile(OpenPictureDialog1.FileName);
// Check if image is monochrome, otherwise prompt a warning
If Image1.Picture.Bitmap.PixelFormat <> pf1bit Then
Begin
ShowWarning('The image is not a monochrome!');
Close;
End;
lImageSize.Caption := IntToStr(Image1.Picture.Width) + ' x ' +
IntToStr(Image1.Picture.Height) + ' mils';
convertbutton.Enabled := True;
LoadButton.Enabled := False;
XStatusBar1.SimpleText := ' Ready...';
XStatusBar1.Update;
End;
End;
Il frammento di codice riportato sopra proviene dal progetto di script PCB Logo Creator, disponibile nella cartella Scripts\Delphiscript Scripts\Pcb\PCB Logo Creator della raccolta di script scaricabile.