combit List & Label - Programmierer-Referenz - combit GmbH

Verwendung der DOM-API (ab Professional Edition)
5.1.1.6. LlDomSetProperty
Erlaubt das Setzen einer Eigenschaft für das angegebene Objekt. Um z.B. den Seitenumbruch
für ein Textobjekt zu erlauben, benötigt man
INT nRet = LlDomSetProperty(hObj, _T("AllowPageWrap"), _T("True"));
WICHTIG: Der Übergabeparameter für den Wert muss eine gültige List & Label-Formel
sein. Eine Besonderheit ergibt sich hierdurch für Eigenschaften, die Zeichenketten
enthalten (z.B. der Inhalt eines Text-Absatzes): Zeichenketten müssen ja innerhalb des
Designers ihrerseits in Anführungszeichen gesetzt werden, um als gültige Formel verwendbar
zu sein. Um also den festen Text "combit" zu übergeben muss der Parameter
"'combit'" verwendet werden. Dies gilt auch z.B. für feste Fontnamen, auch hier muss
z.B. "'Verdana'" übergeben werden, nicht "Verdana",
Beispiel:
LlDomSetProperty(hObj, _T("Contents"), _T("'") + sProjectTitle + _T("'"));
Um die Werte von verschachtelten Eigenschaften wie den der Farbe einer Füllung zu
setzen, kann der Eigenschaftsname "." verwendet
werden, also z.B.
INT nRet = LlDomSetProperty(hObj, _T("Filling.Color"), _T("LL.Color.Black"));
5.1.1.7. LlDomGetProperty
Liest den Wert einer Eigenschaft aus. Es empfiehlt sich, wie üblich zunächst durch
Übergabe eines NULL-Puffers die benötigte Pufferlänge zu ermitteln und dann einen
ausreichend großen Puffer zu allozieren:
INT nBufSize = LlDomGetProperty(hObj, _T("AllowPageWrap"), NULL, 0);
TCHAR* pszBuffer = new TCHAR[nBufSize];
INT nRet = LlDomGetProperty(hObj, _T("AllowPageWrap"), pszBuffer, nBufSize);
…
delete[] pszBuffer;
Zur Vereinfachung können Objekte (nicht aber Listen!) mit Hilfe des Punktes als Hierarchietrenner
auch "durchtunnelt" werden, wie z.B.:
...
// Auslesen der Seitenkoordinaten der ersten Seite
LlDomGetProperty(hRegion,
_T("Paper.Extent.Horizontal"),
pszContainerPositionWidth, nBufSize);
70