TFbmItem.GetNextUserFieldItem

Diese Funktion ist eine Methode der Klasse TFbmItem und welche in der Unit Item definiert wurde. Der Funktionstyp ist Funktion. Der Rückgabetyp ist vom Typ Boolean.
Die Funktion verlangt folgende Parameter:
Parameter
Typ
Beschreibung
Item TFbmItem In diese Objektinstanz wird das Ergebnis der Funktion geladen.
UserFieldRef Integer Die ID des benutzerdefinierten Feldes.
Value string Der Wert des benutzerdefinierten Feldes.
Diese Funktion ermittelt das nächste Element mit dem selben benutzerdefiniertem Feld und dem angegeben Wert. Die Reihenfolge ist dabei nach Element-ID sortiert. Das heißt das Start- und Enddatum des Elements spielt keine Rolle. Wird das vorherige Element gefunden, gibt die Funktion True zurück, ansonsten False. Das übergebene Element wird nur verändert (geladen), wenn die Funktion True zurückliefert.
Quelltext-Beispiel:
1
2
3
4
5
6
7
8
9
10
11
12
13
var
  NextUserFieldItem: TFbmItem;

begin
  NextUserFieldItem := TFbmItem.Create(Item.Kind, 0);

  try
    if Item.GetNextUserFieldItem(NextUserFieldItem, 1, 'K-123456789-5') then
      Item.GroupRef := NextUserFieldItem.GroupRef;
  finally
    NextUserFieldItem.Free;
  end;
end.