NGDesktop UI (ref)

(part of package 'NGDesktop UI')

You can access it in code via: plugins.ngdesktopui

Properties

API

addCheckBox(index,text,callback,checked,position,itemIndex)

Add a checkbox to the specified menu. NOTE: when adding the checkbox to an existing menuitem, that menuitem will turn from type "normal" to type "submenu". If a callback has been set previously, that callback will no longer be called.

Parameters:

• {int} index - menu index

• {string} text Text - checkbox label

• {function} callback - callback function to call. The callback function will receive:- text of the clicked item- type of the clicked item ("normal", "radio", "checkbox")- checked value for checkboxes and radio buttons, otherwise undefined

• {boolean} [checked] - checkbox initial status (unchecked by default)

• {int} [position] - insert position

• {int} [itemIndex] - submenu index; when specified the position is relative to this submenu

Returns: int - the index of the added checkbox

---

addDevToolsMenu()

Add Developer Tools menu to the menu bar

Use it just for debugging. Remove any call to this function once you're done.

---

addMenu(text,index)

Add new menu to the menu bar

Parameters:

• {string} text - menu text
• {int} [index] - menu insert position (zero based)

Returns: int - the index of the added menu

---

addMenuItem(index,text,callback,position,itemIndex)

Add menu items to existing menu. NOTE: when adding an item to an existing menuitem, that menuitem will turn from type "normal" to type "submenu". If a callback has been set previously, that callback will no longer be called.

Parameters:

• {int} index - menu index
• {string} text - menuitem text
• {function} callback - callback function to call. The callback function will receive:- text of the clicked item- type of the clicked item ("normal", "radio", "checkbox")- checked value for checkboxes and radio buttons, otherwise undefined
• {int} [position] - insert position
• {int} [itemIndex] - submenu index; when specified the position is relative to this submenu

Returns: int - the index of the added menu item

---

addRadioButton(index,text,callback,selected,position,itemIndex)

Add a radio button to the specified menu.

NOTE: when adding the checkbox to an existing menuitem, that menuitem will turn from type "normal" to type "submenu". If a callback has been set previously, that callback will no longer be called. NOTE: For the first added radio button in a group, the radio button will be selected ignoring the 'selected' param.

Parameters:

• {int} index - menu index
• {string} text Text - checkbox label
• {function} callback - callback function to call. The callback function will receive:- text of the clicked item- type of the clicked item ("normal", "radio", "checkbox")- checked value for checkboxes and radio buttons, otherwise undefined
• {boolean} [selected] - initial selected status
• {int} [position] - insert position
• {int} [itemIndex] - submenu index; when specified the position is relative to this submenu

Returns: int - the index of the added radio button

---

addRoleItem(index,role,text,position,itemIndex)

Add a menuitem with standard native system behavior. For a complete list of allowed values see: https://github.com/Servoy/ngdesktopui

Parameters:

• {int} index - menu index
• {string} role - item role.
• {string} [text] - menuitem text; when not specified the System will provide a standard (localized) one
• {int} [position] - insert position; when role is a predefined menu, this parameter is ignored;
• {int} [itemIndex] - submenu index; when specified the position is relative to this submenu; when role is a predefined menu this parameter is ignored

Returns: int - the index of the added role item

---

addSeparator(index,position,itemIndex)

Add separator line to the specified menu

Parameters:

• {int} index - menu index
• {int} [position] - insert position
• {int} [itemIndex] - submenu index; when specified the position is relative to this submenu

Returns: int - the index of the added separator

---

closeBrowserView(id)

Closes a and destroys a previously created BrowserView by the given id.

Parameters:

• {int} id - the id of the view to close.

---

createBrowserView(x,y,width,height,url)

Creates a BrowserView (looks like an iframe) and adds this to the current window at the given coordinates with the given width and height. It returns and id that can be used to close/clean up this view later on, or to target that view to inject some javascript.

Parameters:

• {int} x - the X coordinate to position this view
• {int} y - the Y coordinate to position this view
• {int} width - the width of this view
• {int} height - the height of this view
• {string} url - the url to load into this view

Returns: int The id to target this view later on.

---

createTrayMenu()

@return {trayMenu}

Returns: trayMenu

---

getMenuCount()

Count menus from the menu bar.

Returns: int

---

getMenuIndexByText(text)

Return the menu text at the specified position.

Parameters:

• {string} text ** (string) text - the text to query for

Returns: int Menu index containing the specified text; if not found return -1

---

getMenuItemIndexByText(index,text)

Get menuitem index from the specified menu

Parameters:

• {int} index - menu index
• {string} text - menuitem text to query for index

Returns: int

---

getMenuItemText(index,itemIndex)

Get menuitem text from the specified menu

Parameters:

• {int} index - menu index
• {int} itemIndex ItemIndex - menuitem index to query for text

Returns: string

---

getMenuItemsCount(index,itemIndex)

Count menu items for the specified menu

Parameters:

• {int} index - menu index
• {int} [itemIndex] ** (int) [itemIndex] - submenu index; when specified the submenu items will be count

Returns: int

---

getMenuText(index)

Return the menu text from the specified menu position.

Parameters:

• {int} index Position to query for

Returns: string Menu's text; if index is out of range - null is returned

---

getWindowSize()

Get window size

Returns: int[] - an array containing window's width and height

---

getZoomFactor()

Get the zoom factor of the current window

Returns: double Zoom factor of the current window

---

hideWindow()

Hide the window

---

injectJSIntoBrowserView(id,js,callback)

Injects the given javascript into the content of the BrowserView of the given id. The javascript can be a function declaration that is then called later on. The last statement return value is given back to the callback as a first argument. If something goes wrong then the callback is called where the first argument is null and a second argument has the message of the exception.

Example:

// open google.com<br/>
var id = plugins.ngdesktopui.createBrowserView(100,200,700,500,"https://www.google.com/");<br/>
// get the value of the search field and return this.<br/>
plugins.ngdesktopui.injectJSIntoBrowserView(id, "function test() { return document.getElementsByName('q')[0].value};test();", callback);

Parameters:

• {int} id - the id of the view to execute javascript in.
• {string} js Js - the piece of javascript that is injected into this view.
• {function} callback - the callback function that is used to get the results or exception if the call fails.

---

isFullScreen()

Return true if window is in full screen state

Returns: boolean

---

isMaximized()

Return true if window is in maximized state

Returns: boolean

---

isMinimized()

Return true if window is in minimized state

Returns: boolean

---

isNormal()

Return true whether the window is in normal state (not maximized, not minimized, not in fullscreen mode)

Returns: boolean

---

isVisible()

Return true if window is in visible to the user

Returns: boolean

---

maximizeWindow()

Maximize the window

---

minimizeWindow()

Minimize the window

---

registerOnCloseMethod(callback)

Register callback to be executed before closing ngdesktop

Parameters:

• {function} callback Callback - function to be executed before closing ngdesktop. Must return a boolean value: true if ngdesktop will close; false if ngdesktop will not close

Returns: boolean - whether function executed succesfully or not

---

removeAllMenuItems(index,itemIndex)

Cleanup the specified menu

Parameters:

• {int} index Index - menu position
• {int} [itemIndex] - submenu index

---

removeAllMenus()

Cleanup the menubar. For MacOS that means to display a minimal menu

---

removeMenu(index)

Delete menu from the specified position from the menu bar

Parameters:

• {int} index Index - menu position to be deleted

---

removeMenuItem(index,position,itemIndex)

Removes a menu item from an existing menu. NOTE: when the last item from a submenu is removed, that submenu will turn from type "submenu" to type "normal". If a callback has been set previously for the item, that callback will be called from then on.

Parameters:

• {int} index - menu index
• {int} position - menuitem position to be removed
• {int} [itemIndex] - submenu index; when specified the position is relative to this submenu

---

resetMenuToDefault()

Reset ngdesktop menu to default

---

restoreWindow()

Restore the window

---

setFullScreen(flag)

Set window to full screen mode

Parameters:

• {boolean} flag - whether the window should be in fullscreen mode

---

setMenuBarVisibility(visible)

Show/hide menubar visibility. This function is working only on Windows/Linux

Parameters:

• {boolean} visible

---

setWindowSize(width,height)

Set window size to the specified dimensions

Parameters:

• {int} width - width (integer value greater than zero)
• {int} height - height (integer value greater than zero)

---

setZoomFactor(factor)

Set the zoom factor of the current window 1 == 100%. 0.5 == 50%.

Parameters:

• {double} factor Factor (values greater than 0.0 and smaller or equal to 5.0)

Returns: boolean

---

showWindow()

Show and gives focus to the window

---

unmaximizeWindow()

Unmaximize the window

---

unregisterOnCloseMethod()

Unregister the callback to be executed before closing ngdesktop.

---

useDefaultBrowserForExternalLinks(flag)

Set the way external links will be handled from ngdesktop. When the flag parameter is set to: - true: open external links using OS default browser - false: open external links using a new ngdesktop window

Parameters:

• {boolean} flag

---

Types

trayMenu

scripting type: CustomType<ngdesktopui.trayMenu>

• icon

  • Type: byte[]
• pressedIcon

  • Type: byte[]
• title

  • Type: string
• tooltip

  • Type: string

trayMenuItem

scripting type: CustomType<ngdesktopui.trayMenuItem>

• checked

  • Type: boolean
• click

  • Type: function
• label

  • Type: string
• role

  • Type: string
• type

  • Type: string

---