English
Instant Developer Foundation Documentazione
Aiutaci anche tu a migliorare la Documentazione: vai in fondo alla pagina, esprimi la tua valutazione sull'articolo e aggiungi il tuo feedback.
  • Estensibilità
  • Libreria
  • INDE Extension
  • Oggetti

Get Prop Object

funzione link

Scopo

Ritorna il puntatore contenuto in una proprietà di tipo oggetto. Alcune proprietà di questo tipo sono per esempio le proprietà comuni Derivato da e Collegato a.

Sintassi

int IDOggetto = 0  // Puntatore dell'oggetto
// 
IDOggetto := INDE.GetPropObject(id oggetto, proprietà, indice)

Argomenti

ID Oggetto Puntatore dell'oggetto di cui restituire il puntatore contenuto nella 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 restituire il puntatore contenuto. L'elenco delle proprietà disponibili sono contenute nella lista valori Proprietà Comuni e nella liste valori specifiche per tipo.
Indice Indice del puntatore nel caso la proprietà sia una collezione di puntatori. L'elenco dei possibili indici è specificato nella descrizione delle proprietà.

Valore di ritorno

Viene ritornato un intero corrispondente al puntatore contenuto nella proprietà. Se la proprietà non punta ad alcun oggetto verrà restituito ZERO.

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, ??, ??, ??)
      }
    }
  }
}
  • La scrittura delle proprietà di tipo oggetto avviene tramite la funzione SetPropObject.
  • 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

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

Hai trovato utile l'articolo?

Grazie per il feedback!

Ti serve altro aiuto?

Consulta il Forum