rk.XML.browser: Create XML node "browser" for RKWard plugins

View source: R/rk.XML.browser.R

rk.XML.browserR Documentation

Create XML node "browser" for RKWard plugins

Description

Create XML node "browser" for RKWard plugins

Usage

rk.XML.browser(
  label,
  type = "file",
  initial = NULL,
  urls = FALSE,
  filter = NULL,
  required = TRUE,
  id.name = "auto",
  help = NULL,
  component = rk.get.comp(),
  i18n = NULL
)

Arguments

label

Character string, a text label for this plugin element.

type

Character string, valid values are "dir", "file" and "savefile" (i.e., an non-existing file).

initial

Character string, if not NULL will be used as the initial value of the browser.

urls

Logical, whether non-local URLs are permitted or not.

filter

Character vector, file type filter, e.g. filter=c("*.txt", "*.csv") for .txt and .csv files. Try not to induce limits unless absolutely needed, though.

required

Logical, whether an entry is mandatory or not.

id.name

Character string, a unique ID for this plugin element. If "auto" and a label was provided, an ID will be generated automatically from the label.

help

Character string or list of character values and XiMpLe nodes, will be used as the text value for a setting node in the .rkh file. If set to FALSE, rk.rkh.scan will ignore this node. Also needs component to be set accordingly!

component

Character string, name of the component this node belongs to. Only needed if you want to use the scan features for automatic help file generation; needs help to be set accordingly, too!

i18n

Either a character string or a named list with the optional elements context or comment, to give some i18n_context information for this node. If set to FALSE, the attribute label will be renamed into noi18n_label.

Value

An object of class XiMpLe.node.

See Also

Introduction to Writing Plugins for RKWard

Examples

test.browser <- rk.XML.browser("Browse here:")
cat(pasteXML(test.browser))

rkward-community/rkwarddev documentation built on May 9, 2022, 3:02 p.m.