svMisc (version 0.9-46)

addItems: Add items from one vector to another one with or without replacement

Description

The function takes the (named) items of one vector and place them in a second vector if these names do not exist yet there, or replace corresponding content.

Usage

addItems(x, y, use.names = TRUE, replace = TRUE)
addActions(obj = ".svActions", text = NULL, code = NULL, state = NULL,
	options = NULL, replace = TRUE)
addIcons(obj = ".svIcons", icons, replace = TRUE)
addMethods(methods)

Arguments

x

The vector to add items to

y

The vector of which we want to inject missing items in 'x'

use.names

Use names of items to determine which one is unique, otherwise, the selection is done on the items themselves

replace

Do we replace existing items in 'x'?

obj

The name of the object in TempEnv() to manipulate

text

The text of actions to add (label on first line, tip on other lines)

code

The R code of actions to add

state

The default (strating) state of an action, as a succession of letters: "c" = checked, "u" = unchecked (default); "d" = disabled, "e" = enabled (default); "h" = hidden, "v" = visible (default). Default values are facultative. Ex: udv

options

A character vector with other options to pass to the graphical toolkit for this action

icons

A named character vector matching names of actions/panels with the URL or file name of icon resources accessible by the GUI client

methods

The methods to add to getOption("svGUI.methods"). This information is used to compute a list of possible methods for a given object, for instance, in the context menu of an object explorer (see objMenu())

See Also

listMethods, objMenu, TempEnv

Examples

Run this code

# I have a vector v1 with this:
v1 <- c(a = "some v1 text", b = "another v1 text")
# I want to add items whose name is missing in v1 from v2, without touching the rest
v2 <- c(a = "v2 text", c = "the missign item")
addItems(v1, v2, replace = FALSE)
# Not the same as
addItems(v1, v2, replace = TRUE)
# This yield different result (names not used and lost!)
addItems(v1, v2, use.names = FALSE)

# This is useful to add actions, icons, descriptions, shortcuts or methods
# specifs (see addMenuItem())

Run the code above in your browser using DataLab