@FindCategoryByName

Sucht in der Ansicht mit dem VIEWHANDLE VIEWHANDLE1 die Kategorie mit dem Namen TEXT/TEXTLIST NAME2 ab der VIEWPOSITION VIEWPOSITION3 und liefert die VIEWPOSITION im Erfolgsfall zurück.

VIEWPOSITION3 ist eine FNLIST mit 10 Einträgen.
Im 1.Eintrag steht die Anzahl der kategorisierten Spalten, im 10.Eintrag die Anzahl der Einträge in der Kategorie.
Um auf das erste Dokument einer nicht kategorisierten Ansicht zu zeigen muß VIEWPOSITION3 folgende Gestalt haben: 0:1:0:0:0:0:0:0:0:0.

FN FNOPTIONS Bitvektor (optional Engine Version >= 10.02):
1 =    Es wird eine Varibale vom Type VIEWPOS zurückgegeben und keine VIEWPOSITION.

Ab Engine V10.02 wird der Eingabe-Parameter VIEWPOSITION VIEWPOSITION3 ignoriert und kann beliebig sein!

Beispiel: @FindCategoryByName(VIEWHANDLE1;NAME2;VIEWPOSITION3)

VIEWPOSITION3:=@BuildList(0;10);
DBHANDLE:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE;"TEST VIEW");
@LogReport(@FindCategoryByName(VIEWHANDLE1;"EINS";VIEWPOSITION3));
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE:=@CloseDB(DBHANDLE);

Es wird die Datenbank mit NotesPath "TEST.NSF" und die Ansicht mit dem Namen "TEST VIEW" geöffnet , die Kategorie "EINS" in der Ansicht "TEST VIEW" wird gesucht und die VIEWPOSITION des ersten Dokuments in dieser Kategorie ausgegeben.
Schließlich wird die Datenbank und die Ansicht wieder geschlossen.