Note.Open

Description

• Creates a new note or opens an existing note (or notes) & returns the note's handle.

Syntax

• Note.Open(fpath, cat_expr)

Parameters

fpath

(string) full path to a note, including .ppronote extension

Optional, if omitted, a new note is created.

If specified, the note must already exist.

cat_expr

(string) category string, in format "cat catname" where catname=category name

Optional, but it must be the 2nd parameter, & the 1st parameter must be an empty string (otherwise the 2nd parameter is ignored).

Return Value

• (integer) the note's handle

Examples

• Note.Open
  • Opens a new note.
• global nh = Note.Open
  • Opens a new note & assigns its handle to the global variable nh.
• Note.Open(pprofolder++?"notes\dev\stuff.ppronote")
  • Opens the note "stuff.ppronote".
• Note.Open("", "cat work")
  • Opens a new note in category "work".
• Note.Open("","cat "++date)
  • Opens a new note with its category set to today's date.