Italian community of Lazarus and Free Pascal

Proprietà

vediamo cosa sono e come vengono gestite.....

Fino ad ora per accedere a qualcosa all'interno di un oggetto abbiamo usato procedure, funzioni e, perchè no, variabili. Ma possiamo aver necessità di assegnare un valore e, dopo l'assegnazione, fare qualcosa, oppure impedire l'assegnazione di un valore fuori da un determinato range, oppure accedere a vettori contenuti all'interno di un oggetto, oppure rendere delle variabili/procedure visibili dall'object inspector (magari per la creazione di un nuovo componente).

Le proprietà sono identificate nel seguente modo:

Property : Read Write Default

dove:
è il nome della proprietà vista dall'esterno
è il tipo (byte, string, boolean, etc..)
è la funzione usata per restituire il valore
è la funzione per assegnare il valore
è il valore di inizializzazione

Nota: Le parti Read, Write e Default possono essere omesse (almeno o Read o Write deve essere presente)

Bene vediamo come muoverci con un piccolo esempio:

Il nostro oggetto, che per semplicità chiameremo, TOfficina gestisce una serie di macchine e memorizzate con targa, proprietario e difetto e salvate in un array di record identificati come:

RecMacchina = Record
                 Targa           : String;
                 Proprietario    : String;
                 Difetto         : String;
                 LavoroTerminato : Boolean;
              End;
             
Per iniziare facciamo che l'oggetto possa contenere una sola macchina e quindi, internamente, avrà una variabile identificata come

Macchina : RecMacchina

Ora vogliamo creare le proprietà per leggere e modificare le caratteristiche della macchina; a tale scopo usiamo le seguenti proprietà:

Property Targa        : String  Read Leggi_Targa        Write Scrivi_Targa;
Property Proprietario : String  Read Leggi_Proprietario Write Scrivi_Proprietario;
Property Difetto      : String  Read Leggi_Difetto      Write Scrivi_Difetto;
Property Terminato    : Boolean Read Leggi_Terminato    Write Scrivi_terminato

come si vede abbiamo identificato:

1) Il nome della proprietà visibile dall'esterno (Targa, Proprietario, ...)
2) Cosa fare per accedere ai dati il lettura (Leggi_Targa, Leggi_Proprietario, ...)
3) Cosa fare per accedere ai dati in scrittura (Scrivi_Targa, Scrivi_Proprietario, ...)

quelle usate in lettura saranno funzioni mentre quelle in scrittura saranno procedure identificate cosi':

Function Leggi_Targa : String;
Procedure Scrivi_Targa(Valore : String);
......

sviluppate in maniera simile a questa:

Function Leggi_Targa : String;
Begin
  Result := Macchina.Targa;
End;

Procedure Scrivi_Targa(Valore : String);
Begin
  Macchina.Targa := Valore;
End;
.......

come vedete, dall'esterno sarà come scrivere o leggere delle semplici variabili:

MioOggetto.Targa := 'AZ 1234 BB';

Ora complichiamoci la vita dichiarando la variabile Macchina come un array

Macchina : Array[1..10] Of RecMacchina;

quindi per accedervi dobbiamo necessariamente modificare le nostre proprietà aggiungendo l'indice:

Property Targa[Indice : Integer]        : String  Read Leggi_Targa        Write Scrivi_Targa;
Property Proprietario[Indice : Integer] : String  Read Leggi_Proprietario Write Scrivi_Proprietario;
Property Difetto[Indice : Integer]      : String  Read Leggi_Difetto      Write Scrivi_Difetto;
Property Terminato[Indice : Integer]    : Boolean Read Leggi_Terminato    Write Scrivi_terminato

e, ovviamente, modificare le funzioni di lettura/scrittura aggiungendo anche li il nostro indice:

Function Leggi_Targa(Indice : Integer) : String;
Procedure Scrivi_Targa(Indice : Integer; Valore : String);
......

sviluppate in maniera simile a questa:

Function Leggi_Targa(Indice : Integer) : String;
Begin
  Result := Macchina[Indice].Targa;
End;

Procedure Scrivi_Targa(Indice : Integer; Valore : String);
Begin
  Macchina[Indice].Targa := Valore;
End;
.......

Ora, dall'esterno, per accedervi dobbiamo aggiungere l'indice anche li'

MioOggetto.Targa[2] := 'AZ 1234 BB';

una piccola nota... il campo default, per le proprietà che accedono a vettori o matrici, cambia significato e non è più il valore di default ma la proprietà di default che puo' essere chiamata anche sensa specificarla

Esempio se dichiariamo

Property Targa[Indice : Integer]        : String  Read Leggi_Targa        Write Scrivi_Targa         Defalt;
Property Proprietario[Indice : Integer] : String  Read Leggi_Proprietario Write Scrivi_Proprietario;
Property Difetto[Indice : Integer]      : String  Read Leggi_Difetto      Write Scrivi_Difetto;
Property Terminato[Indice : Integer]    : Boolean Read Leggi_Terminato    Write Scrivi_terminato

diciamo a Lazarus che Targa si puo' chiamare cosi'

MioOggetto.Targa[4]

oppure cosi':

MioOggetto[4]

Note:

• Le proprietà possono essere dichiarate nella sezione public o published dell'oggetto fatta eccezzione per quelle ad accesso a strutture vettori o matrici che non possono essere dichiarate nella sezione published
  Nel caso di componente le proprietà dichiarate nella sezione published sono visibili nell'object inspector