File: u0_shellexec.wcc.Rd

package info (click to toggle)
r-cran-pbdzmq 0.3.13%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 856 kB
  • sloc: ansic: 737; sh: 93; pascal: 30; cpp: 6; makefile: 4
file content (65 lines) | stat: -rw-r--r-- 1,927 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/shellexec_wcc.r
\name{shellexec.wcc}
\alias{shellexec.wcc}
\title{Shell Execution via cmd windows}
\usage{
shellexec.wcc(file, SW.cmd = 7L)
}
\arguments{
\item{file}{a file name as in \code{shell.exec}()}

\item{SW.cmd}{a SW_* command of showing windows}
}
\value{
A new windows with certain applications depending on the association
of the input \code{file}.
}
\description{
This function is an extension to the \code{shell.exec}() which is a native
function of R
}
\details{
\code{shell.exec("a.txt")} will open a windows (notepad) to edit the file
\code{a.txt} in windows system. However, the notepad will block the (parent)
active R windows, i.e. \code{SW.cmd = 5} as \code{SH_SHOW} by default.

The \code{shellexec.wcc("a.txt", SW.cmd = 7L)} will open the notepad, but in
a minimized window. Therefore, there is no blocking to the active R windows.
See the website in the references section to see more options to control the
behavior of new windows. Possible choices are

\code{SW_SHOW (5)}: Activates the window and displays it in its current size
and position.

\code{SW_SHOWMINIMIZED (2)}: Activates the window and displays it as a
minimized window.

\code{SW_SHOWMINNOACTIVE (7)}: Displays the window as a minimized window.
The active window remains active.

\code{SW_SHOWNA (8)}: Displays the window in its current state.  The active
window remains active.
}
\examples{
\dontrun{
library(pbdZMQ, quietly = TRUE)

shellexec.wcc("a.txt", 5L)
}

}
\references{
Microsoft, Windows Dev Center: Windows desktop applications >
Develop > Desktop technologies > Desktop Environment > The Windows Shell >
Shell Reference > Shell Functions > ShellExecute

\code{https://msdn.microsoft.com/en-us/library/windows/desktop/bb762153(v=vs.85).aspx}
}
\seealso{
\code{shell.exec()}.
}
\author{
Wei-Chen Chen \email{wccsnow@gmail.com}.
}
\keyword{internal}