Syntax:

INT LlPrintIsFieldUsed(HLLJOB hJob, LPCTSTR lpszFieldName);

Aufgabe:

Gibt an, ob das angegebene Feld von dem geladenen Projekt verwendet wird. Um die Abfrage schon vor dem Druck für alle Felder durchzuführen, sollten Sie besser LlGetUsedIdentifiers verwenden.

Parameter:

hJob: List & Label-Job-Handle

lpszFieldName: Feldname

Rückgabewert:

Ein gültiger Wert ist größer als 0. Ist der Wert kleiner 0, handelt es sich um einen Fehlercode. Für weitere Details siehe die Kapitel Allgemeines zum Rückgabewert und Fehlercodes.

Hinweise:

Diese Funktion kann erst nach LlPrintStart() oder LlPrintWithBoxStart() aufgerufen werden.

Diese Funktion setzt voraus, dass LL_OPTION_NEWEXPRESSIONS auf TRUE steht (Voreinstellung).

Ein Aufruf von LlDefineFieldStart() löscht die "Benutzt"-Flags, so dass diese Funktion direkt danach immer LL_­ERR_­UNKNOWN zurückmeldet, daher darf LlDefine­FieldStart() nur vor LlPrint[WithBox]Start() verwendet werden.

Statt eines einfachen Feldnamens kann auch eine Wildcard-Suche verwendet werden. Dies ist immer dann nützlich, wenn Sie Ihre Felder hierarchisch anmelden, z. B. alle Felder der Tabelle "Artikel" in der Form "Artikel.Nr", "Artikel.Bezeichnung" usw. Um zu überprüfen, ob die Artikel-Tabelle überhaupt benötigt wird, können Sie dann für den Parameter lpszFieldName "Artikel*" übergeben.

Beispiel:

if (LlPrintIsFieldUsed(hJob, "Name")==1)
   LlDefineFieldExt(hJob, "Name",<...>);

Siehe auch:

LlPrintStart, LlPrintWithBoxStart, LlPrintIsVariableUsed, LlPrintIsChartFieldUsed