ComPropSet

obj -> ComPropSet(alpha1, var2[, int3, ..., int6]) : int

Eigenschaft eines COM-Objektes setzen

Details

• obj: COM-Objekt
• alpha1: Name der Eigenschaft
• var2: Wert der Eigenschaft
• int3-int6: zusätzliche Informationen
• Resultat: int Funktion erfolgreich (= _ErrOk )
• Siehe: Verwandte Befehle , ComOpen () , ComPropSetText () , ComPropGet ()

Dieser Befehl setzt eine Eigenschaft eines COM-Objektes.

In (obj) wird der Deskriptor des COM-Objektes und in (alpha1) der Name der zu setzenden Eigenschaft übergeben. Der Wert der Eigenschaft wird in (var2) angegeben.

Die Typenüberprüfung findet erst zur Laufzeit statt.

Über den Rückgabewert kann überprüft werden, ob das Setzen der Eigenschaft gelungen ist (Rückgabewert = _ErrOk) oder nicht.

Beispiel:

...
// Microsoft Word starten
tComApp # ComOpen('Word.Application', _ComAppCreate);

// Eigenschaft Caption der Applikation setzen
if (tComApp->ComPropSet('Caption', 'Ausgabe') != _ErrOk)
{
  WinDialogBox(0, 'Fehlermeldung',
    'Fehler beim Setzen der Eigenschaft Caption.',
    _WinIcoError, _WinDialogOK, 0);
}
...

Das Setzen der Eigenschaft kann ebenfalls über entsprechende Konstanten erfolgen. Die Zusammensetzung der Konstanten ist im Abschnitt COM-Befehle beschrieben.

Beispiel:

...
// Microsoft Word starten
tComApp # ComOpen('Word.Application', _ComAppCreate);

// Eigenschaft Caption der Applikation setzen
tComApp->cpaCaption # 'Ausgabe';

Muss bei einer Eigenschaft ein Parameter vom Typ Enum angegeben werden, kann der entsprechende Parameter in (int3) angegeben werden. Bei der Verwendung von Konstanten wird der Parameter in einer Klammer hinter der Konstanten angegeben.

Soll die erweiterte Eigenschaft Array gesetzt werden, muss in den Parametern (int3) - (int6) die Zelle des Arrays angegeben werden.

// Zelle eines 2-dimensionales Arrays setzen
tArray->ComPropSet('Item', 'Jahr', 1, 1);