@GetNoteIDsByPosition
Syntax
@GetNoteIDsByPosition(VIEWHANDLE1;VIEWPOSITION2);
Beschreibung
Holt in der Ansicht mit dem VIEWHANDLE VIEWHANDLE1 ab der Position VIEWPOSITION/VIEWPOS VIEWPOSITION2 die NoteIDs und gibt sie als IDLIST zurück. In der Position 10 der VIEWPOSITION/VIEWPOS VIEWPOSITION2 wird die Anzahl der zu lesenden NoteIDs festgelegt.
(Ist die Position 10 der VIEWPOSITION/VIEWPOS VIEWPOSITION2 gleich 0 (NULL) wird bis zur nächsten Kategorie oder bis zum Ende der View gelesen.)
VIEWPOSITION2 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.
Beispiel: @GetNoteIDsByPosition(VIEWHANDLE1;VIEWPOSITION2)
VIEWPOSITION2:=1:1:1:0:0:0:0:0:0:0;
DBHANDLE:=@OpenDB("TEST.NSF");
VIEWHANDLE1:=@OpenView(DBHANDLE;"TEST VIEW");
VIEWPOSITION2:=@FindCategoryByName(VIEWHANDLE1;"EINS";VIEWPOSITION2);
IDLIST:=@GetNoteIDsByPosition(VIEWHANDLE1;VIEWPOSITION2);
VIEWHANDLE1:=@CloseView(VIEWHANDLE1);
DBHANDLE:=@CloseDB(DBHANDLE);
Es wird eine Datenbank und eine Ansicht geöffnet.
Es wird die Kategorie "EINS" gesucht und anschließend alle unter dieser Kategorie befindlichen Dokumente IDLIST IDLIST zugewiesen (@FindCategoryByName liefert automatisch im 10.ten Element der zurückgegebenen VIEWPOSITION die Anzahl der unter dieser Kategorie befindlichen Dokumente).
Die Datenbank und die Ansicht werden wieder geschloßen.
