R winMenus MS Windows 下的用戶菜單 (Rgui)

說明

使用戶能夠在 MS Windows 中為 Rgui 添加、刪除和編程菜單。

用法

winMenuAdd(menuname)
winMenuAddItem(menuname, itemname, action)
winMenuDel(menuname)
winMenuDelItem(menuname, itemname)
winMenuNames()
winMenuItems(menuname)

參數

menuname	命名菜單的字符串。
itemname	命名現有菜單上的菜單項的字符串。
action	說明選擇該菜單時的操作的字符串，或 "enable" 或 "disable" 。

細節

用戶菜單添加到現有菜單的右側，項目添加到菜單底部。

默認情況下，操作字符串被視為R輸入，在命令行上回顯並像平常一樣解析和執行。

如果winMenuAddItem 的menuname 參數尚不存在，則會自動創建。

通常，新的子菜單和菜單項會添加到主控製台菜單中。它們可以使用以下特殊名稱添加到其他地方：

$ConsoleMain

控製台菜單(默認)

$ConsolePopup

控製台彈出菜單

$Graph<n>Main

圖形窗口菜單<n>

$Graph<n>Popup

圖形窗口的彈出菜單<n>

在 winMenuAddItem 中指定現有項目可以更改操作。

可以通過用斜杠分隔 menuname 中的元素來指定子菜單：因此菜單名稱可能不包含斜杠。

如果 action 指定為 "none" 則不執行任何操作：這對於保留項目以供將來擴展非常有用。

函數winMenuNames可用於找出用戶創建了哪些菜單並返回現有菜單名稱的向量。

winMenuItems 函數將獲取菜單名稱並返回該菜單中存在的項目。返回值是一個命名向量，其中名稱對應於項目的名稱，向量的值是相應的操作。

winMenuDel 函數將刪除菜單及其所有項目和子菜單。 winMenuDelItem 僅刪除一個菜單項。

項目的總路徑(菜單字符串加項目字符串)不能超過 1000 個字節，菜單字符串不能超過 500 個字節。

值

NULL，隱形。如果發生錯誤，將給出一條信息性錯誤消息。

注意

這些函數僅在 Windows 上可用，並且僅在使用 Rgui 時可用，因此在 ESS 和 RStudio 中均不可用。

例子

## Not run: 
winMenuAdd("Testit")
winMenuAddItem("Testit", "one", "aaaa")
winMenuAddItem("Testit", "two", "bbbb")
winMenuAdd("Testit/extras")
winMenuAddItem("Testit", "-", "")
winMenuAddItem("Testit", "two", "disable")
winMenuAddItem("Testit", "three", "cccc")
winMenuAddItem("Testit/extras", "one more", "ddd")
winMenuAddItem("Testit/extras", "and another", "eee")
winMenuAdd("$ConsolePopup/Testit")
winMenuAddItem("$ConsolePopup/Testit", "six", "fff")
winMenuNames()
winMenuItems("Testit")

## End(Not run)

也可以看看

winDialog