PrtPropSet

obj -> PrtPropSet(int1, var2[, int3]) : logic

Auslesen einer Eigenschaft eines Druckobjektes

Details

• obj: Objekt
• int1: Konstante der Eigenschaft
• var2: Zu setzender Wert
• int3: Zusätzliche Information
• Resultat: logic Funktion erfolgreich
• Siehe: Verwandte Befehle , PrtPropGet () , Alphabetische Liste aller Eigenschaften

Dieser Befehl setzt eine Eigenschaft eines Druckobjektes.

Als erster Parameter muss die Konstante der Eigenschaft übergeben werden. Die Konstanten setzen sich aus _PrtProp und dem Name der Eigenschaft zusammen.

Im zweiten Parameter wird der zu setzende Wert übergeben.

Beispiel:

// Setzen des Objektitels auf "Neu"
$Text->PrtPropSet(_PrtPropCaption, 'Neu');

info

Alternativ kann die Eigenschaft auch wie folgt gesetzt werden:

Beispiel:

// Setzen des Objektitels auf "New"
$Text->ppCaption # 'New';

Ein Vorteil neben der kompakteren Schreibweise gegenüber PrtPropSet und PrtPropGet () besteht darin, dass schon während der Kompilierung eine Typprüfung vorgenommen wird:

$Object->PrtPropSet(_PrtPropCaption, 100);

liefert während der Laufzeit den Rückgabewert false, da 100 vom Typ int ist.

$Object->ppCaption # 100;

erzeugt bereits während der Kompilierung der entsprechenden Prozedur einen Fehler. Typ-Fehler dieser Art werden somit vermieden. Beim Lesen einer Eigenschaft, die im referenzierten Objekt nicht vorhanden ist, wird ein Laufzeitfehler erzeugt. Der Laufzeitfehler kann durch die Kapselung in einem try-Block unterbunden werden.

Beispiel

try
{
  ErrTryCatch(_ErrPropInvalid, true);
  $Objekt->ppCaptionInt # 100; 
  ...
}

Der optionale Parameter (int3) muss nur angegeben werden, wenn zusätzliche Informationen einer Eigenschaft zugeordnet werden können. Entsprechende Hinweise befinden sich in den Beschreibungen der Eigenschaften.