Get Prop String

funzione copia link

Scopo

Legge il valore di una proprietà di tipo stringa di un oggetto. L'uso più comune di questa funzione è quello di leggere il nome o la descrizione degli oggetti.

Sintassi

string valore = "" // Valore della proprietà
//
valore := INDE.GetPropString(id oggetto, proprietà, indice)

Argomenti

ID Oggetto	Puntatore dell'oggetto di cui leggere la proprietà. Solitamente il puntatore ad un oggetto viene recuperato tramite una delle seguenti funzioni: GetNextObject, GetObjectByID, GetObjectByCode, GetObjectByName, GetParentObject, GetPropObject.
Proprietà	Indice della proprietà di cui leggere il valore. L'elenco delle proprietà disponibili sono contenute nella lista valori Proprietà Comuni e nella liste valori specifiche per tipo.
Indice	Indice del valore nel caso la proprietà sia una collezione di valori. L'elenco dei possibili indici è specificato nella descrizione delle proprietà.

Valore di ritorno

Viene ritornata una stringa con il valore della proprietà.

Note

In alcuni casi la proprietà può non essere un semplice valore, ma una collezione di valori; ad esempio la proprietà Espressioni del tipo Funzione di Liberira contiene una collezione di stringhe (il numero dipende da se la funzione è della libreria database o client) che corrispondono alle varie implementazioni nei vari database o nei vari linguaggi. Quindi quando si vuole leggere l'implementazione per Access 2000 di una funzione della libreria database occorre valorizzare anche il parametro Indice con valore Access 2000. In caso di proprietà singole il parametro Indice va omesso o impostato a ZERO.
La scrittura delle proprietà di tipo stringa avviene tramite la funzione SetPropString.
Se il puntatore passato come parametro ID Oggetto non corrisponde ad alcun oggetto nel progetto aperto, allora verrà generata un'eccezione.

Esempio di codice

while True = True
{
  int ObjID = 0   // Identificativo dell'oggetto
  int ObjType = 0 // Tipo di oggetto
  //
  // Passo al prossimo oggetto
  ObjID := tw.GetNextObject()
  if ObjID = ZERO
  {
    break
  }
  //
  // Leggo il tipo dell'oggetto
  ObjType := INDE.GetObjectType(ObjID)
  //
  // Se è una tabella non importata
  // oppure è un campo di una tabella non importata
  if (ObjType = Tabella AND INDE.TestFlag(ObjID, Importato) = False)
    OR (ObjType = Campo Tabella AND INDE.TestFlag(INDE.GetParentObject(
    ObjID, Tabella, ??, ??, ??, ??), Importato) = False)
  {
    this.IndividuaParole(INDE.GetPropString(ObjID, Nome, ??), True)
  }
}

In questo esempio di codice, contenuto nella procedura Importa del progetto Gestione Glossario, questa funzione viene usata per leggere il nome delle tabelle e dei campi.

Ultima modifica: 22/08/2008 / Validità: da 7.1.3300