English
Instant Developer Foundation Documentazione
  • Estensibilità
  • Libreria
  • INDE Extension
  • Oggetti

Get Prop Integer

funzione link

Scopo

Legge il valore di una proprietà di tipo intero di un oggetto. Ad esempio può essere utilizzata per leggere il numero di righe di una tabella o la lunghezza di un campo.

Sintassi

int valore = 0  // Valore della proprietà
// 
valore := INDE.GetPropInteger(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 un intero con il valore della proprietà.

Esempio di codice

try
{
  INDEExtension INDE = null // Oggetto INDE
  int IDDocumento = 0       // Puntatore del documento
  // 
  // Mi connetto a IN.DE

  INDE.Connect()
  // 
  // Recupero il puntatore del documento aperto

  IDDocumento := INDE.GetActiveDocument()
  // 
  // Se c'è un documento aperto

  if IDDocumento > ZERO
  {
    int IDProgetto = 0 // Puntatore al progetto
    int IDOggetto = 0  // Puntatore dell'oggetto
    // 
    // Recupero il puntatore del progetto

    IDProgetto := INDE.GetRootObject(IDDocumento)
    // 
    Ricerca dell'oggetto
      ...
    // 
    Lettura e modifica dell'oggetto
    {
      // Se ho trovato l'oggetto
      if IDOggetto > ZERO
      {
         string GUID = ""    // GUID dell'oggetto
         int NumeroRighe = 0 // Numero di righe
         int DerivataDa = 0  // Puntatore dell'oggetto da cui deriva
         // 
         // Leggo alcune proprietà

         GUID := INDE.GetPropGUID(IDOggetto, GUID, ??)
         NumeroRighe := INDE.GetPropInteger(IDOggetto, Numero righe, ??)
         DerivataDa := INDE.GetPropObject(IDOggetto, Derivato da, ??)
         // 
         // Scrivo alcune proprietà

         INDE.SetPropGUID(IDOggetto, GUID, 4F6DEA72-5C55-E16E-C4D8-
           00DBCB8BC4A6, ??, ??)
         INDE.SetPropInteger(IDOggetto, Numero righe, NumeroRighe, ??,
           ??)
         INDE.SetPropObj(IDOggetto, Derivato da, DerivataDa, ??, ??)
         // 
         // Cancello l'oggetto

         INDE.DeleteObject(IDOggetto, ??, ??, ??)
      }
    }
  }
}
  • In alcuni casi la proprietà può non essere un semplice valore, ma una collezione di valori; ad esempio la proprietà Posizione degli oggetti di tipo Campo di Pannello contiene quattro valori come si può vedere dalla lista valori Indici Posizione Campo. Quindi quando si vuole leggere la posizione X in lista di un campo di pannello occorre valorizzare anche il parametro Indice con valore Posizione X (lista). In caso di proprietà singole il parametro Indice va omesso o impostato a ZERO.
  • La scrittura delle proprietà di tipo intero avviene tramite la funzione SetPropInteger.
  • Se il puntatore passato come parametro ID Oggetto non corrisponde ad alcun oggetto nel progetto aperto, allora verrà generata un'eccezione.

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

Vedi anche

  • Set Prop Integer (procedura)
  • Get Next Object (funzione)
  • Get Parent Object (funzione)
  • Get Prop Object (funzione)
  • Get Object By Name (funzione)
  • Get Object By ID (funzione)
  • Get Object By Code (funzione)

Hai trovato utile l'articolo?

Grazie per il feedback!

Ti serve altro aiuto?

Consulta il Forum