Function EN Version 4.50

@SetDBLaunchOptions

Database NotesSystem TimeDate

Syntax

@SetDBLaunchOptions(DBHANDLE1;FNOPTIONS);
@SetDBLaunchOptions(DBHANDLE1;FNOPTIONS;TEXTLIST1);
@SetDBLaunchOptions(DBHANDLE1;FNOPTIONS;TEXTLIST1;RID1;UIDVIEW1;UIDNOTE1);

Description

Sets the database launch options of the database identified by DBHANDLE DBHANDLE1.
FN FNOPTIONS specifies the database launch options of the database.
TEXTLIST TEXTLIST1 specifies the names of the navigators or the view.

RID RID1 specifies the RID of the database to which the DocLink should point, if flag HEX 00400 is set.
UID UIDVIEW1 specifies the UID of the view in which the document to which the DocLink should point can be found, if flag HEX 00400 is set. @ZeroOID can also be specified here.
UID UIDNOTE1 specifies the UID of the document to which the DocLink should point, if flag HEX 00400 is set.
UID UID1 specifies the UID of the document that should be opened if flag HEX 00400 is set.

TEXTLIST1:
Element 1: Navigator name for flags HEX 00008/00010.
Element 2: Web navigator name for flag HEX 00100.
Element 3: Web view for flag HEX 00200.

FNOPTIONS:
BIT   DEC   HEX   BEDEUTUNG if set

01   000001   00001   Don’t Show "About database" document when database is opened for first time   *
02   000002   00002   Show "About database" document if modified   *
03   000004   00004   On Database Open: Open "About database" document   *
04   000008   00008   On Database Open: Open designated Navigator   *
05   000016   00010   On Database Open: Open designated Navigator in its own Window   *
06   000032   00020   On Database Open: Launch first attachment in "About database"   *
07   000064   00040   On Database Open: Launch first doclink in "About database"   *
08   000128   00080   On Database Open from Web: Open "About database" document   *
09   000256   00100   On Database Open from Web: Open designated Navigator in its own Window   *
10   000512   00200   On Database Open from Web: Launch first document in View   *
11   001024   00400   On Database Open from Web: Launch designated doclink   *
12   002048   00800   On Database Open from Web: Launch first doclink in "About database"   *
13   004096   01000   Preview Pane: Location Bottom Right   *
14   008192   02000   Preview Pane: Location Right   *
15   016384   04000   Preview Pane: Maximize document preview on database open
16   032768   08000   Unknown 1
17   065536   10000   Unknown 2
18   131072   20000   Unknown 3

* If none of these bits is set, only the flags marked * apply; in addition, the database is reopened at the location where it was last left by the respective user.
* Flag HEX 00010 should always be specified only together with flag HEX 00008 (not HEX 00010 without HEX 00008).
* If none of these flags is set, the same options are applied as when opening the DB through Notes.
* If none of these flags is set, "Location Bottom" is assumed.
* At most one of the flags may be set.
* At most one of the flags may be set.
* At most one of the flags may be set.
* At most one of the flags may be set.

Example @SetDBLaunchOptions(DBHANDLE1;FNOPTIONS;TEXTLIST1;RID1;UIDVIEW1;UIDNOTE1):

DBHANDLE1:=@OpenDB("TEST1.NSF");
DBHANDLE2:=@OpenDB("TEST2.NSF");
FNOPTIONS:=@GetDBLaunchOptions(DBHANDLE1;TLNAMES;DOCLINKRID;DOCLINKUIDVIEW;DOCLINKUIDNOTE);
@LogReport(FNOPTIONS);
@LogReport(TLNAMES);
@LogReport(@Text(DOCLINKRID;"*"));
@LogReport(DOCLINKUIDVIEW);
@LogReport(DOCLINKUIDNOTE);

FNOPTIONS:=@SetDBLaunchOptions(DBHANDLE2;FNOPTIONS;TLNAMES;DOCLINKRID;DOCLINKUIDVIEW;DOCLINKUIDNOTE);
DBHANDLE1:=@CloseDB(DBHANDLE1);
DBHANDLE2:=@CloseDB(DBHANDLE2);

The databases "TEST1.NSF" and "TEST2.NSF" are opened. The database launch options of the database "TEST1.NSF" are then retrieved and output.
After that, the retrieved database launch options are set in the database "TEST2.NSF", and both databases are closed.

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