@FindCategoryByName

Searches in the view with the VIEWHANDLE VIEWHANDLE1 the category with the name TEXT/TEXTLIST NAME2 ab the VIEWPOSITION VIEWPOSITION3 and liefert the VIEWPOSITION on success.

VIEWPOSITION3 is an FNLIST with 10 entries.
The first entry contains the number of categorized columns, and the tenth entry contains the number of entries in the category.
To point to the first document in a non-categorized view, VIEWPOSITION3 must have the following form: 0:1:0:0:0:0:0:0:0:0.

FN FNOPTIONS bit vector (optional Engine Version >= 10.02):
1 =    A variable of type VIEWPOS is returned and no VIEWPOSITION.

As of Engine V10.02, the input parameter VIEWPOSITION VIEWPOSITION3 is ignored and can have any value!

Example: @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);

The database with NotesPath "TEST.NSF" and the view named "TEST VIEW" are opened, the category "EINS" in the view "TEST VIEW" is searched for, and the VIEWPOSITION of the first document in this category output.
Finally, the database and the view are closed again.

Note : This text was machine-translated and may contain inaccuracies.