TFbmGroupCache.GetGroupRefByNameMask

Diese Funktion ist eine Methode der Klasse TFbmGroupCache und welche in der Unit Caches definiert wurde. Der Funktionstyp ist Funktion. Der Rückgabetyp ist vom Typ Integer.
Die Funktion verlangt folgende Parameter:
Parameter
Typ
Beschreibung
NameMask string Die Maske der gesuchten Gruppe.
CategoryRef Integer Beschränkung auf eine bestimmte Benutzergruppe. Wenn der Wert 0 ist, wird in allen Benutzergruppen gesucht.
Liefert die ID einer Gruppe mit einer bestimmten Maske in einer bestimmten Benutzergruppe zurück.
Beispiele:
1
2
3
4
5
// Findet die erste Gruppe, welche mit "Freigabe" beginnt:
Item.GroupCache.GetGroupRefByNameMask('Freigabe*', 123);

// Findet "1 Freigabelevel Kundenservice":
Item.GroupCache.GetGroupRefByNameMask('[0-9]? Freigabelevel*', 123);
Eine Maske besteht aus literalen Zeichen, Platzhaltern und Mengendefinitionen.
  • Literale Zeichen müssen exakt wie angegeben auftauchen, damit die Maske passt.

  • Mit den Platzhaltern "?" und "*" können beliebige Zeichen ersetzt werden. Das Fragezeichen "?" steht dabei für ein einzelnes, und das Sternchen "*" für eine beliebige Anzahl von Zeichen.

  • Mengendefinitionen beginnen mit einer eckigen, öffnenden Klammer "[" und enden mit einer eckigen, schließenden Klammer "]". Sie beinhalten eine oder mehrere Bereiche die unterschiedliche Zeichen darstellen. Beispiele sind "[0-9]" für eine beliebige Zahl, "[a-z]" für ein beliebiges, kleines Zeichen, oder "[A-F]" für ein beliebiges, großes Zeichen zwischen "A" und "F". Eine Menge kann mit einem Ausrufezeichen "!" invertiert werden. D.h. die Maske passt, wenn die angegebenen Zeichen nicht in dem Bereich enthalten sind. Mehrere Bereiche können ohne Trennzeichen hintereinander weg definiert werden. Beispielsweise steht "[0-9a-z]" für ein beliebiges Zeichen des Alphabets oder einer Zahl zwischen 0 und 9.

    Bei allen Vergleichen wird die Groß- und Kleinschreibung nicht berücksichtig.