Class: Win32::StartupInfo

Inherits:
Object
  • Object
show all
Defined in:
lib/Win32/Process.rb

Overview

This class contains the startup info that is passed to Win32::Process.Create It tells how the process should be created and where it should appear

Constant Summary collapse

STARTF_USESHOWWINDOW =

constsFor: “Startup Information Flags” (from WinBase.h)

0x00000001
STARTF_USESIZE = 
0x00000002
STARTF_USEPOSITION = 
0x00000004
STARTF_USECOUNTCHARS = 
0x00000008
STARTF_USEFILLATTRIBUTE = 
0x00000010
STARTF_RUNFULLSCREEN = 
0x00000020
STARTF_FORCEONFEEDBACK = 
0x00000040
STARTF_FORCEOFFFEEDBACK = 
0x00000080
STARTF_USESTDHANDLES = 
0x00000100
STARTF_USEHOTKEY = 
0x00000200
FOREGROUND_BLUE = 
0x0001
FOREGROUND_GREEN = 
0x0002
FOREGROUND_RED = 
0x0004
FOREGROUND_INTENSITY = 
0x0008
BACKGROUND_BLUE = 
0x0010
BACKGROUND_GREEN = 
0x0020
BACKGROUND_RED = 
0x0040
BACKGROUND_INTENSITY = 
0x0080
SW_HIDE =

constsFor: “Show Window values” (from WinUser.h)

0
SW_SHOWNORMAL = 
1
SW_NORMAL = 
1
SW_SHOWMINIMIZED = 
2
SW_SHOWMAXIMIZED = 
3
SW_MAXIMIZE = 
3
SW_SHOWNOACTIVATE = 
4
SW_SHOW = 
5
SW_MINIMIZE = 
6
SW_SHOWMINNOACTIVE = 
7
SW_SHOWNA = 
8
SW_RESTORE = 
9
SW_SHOWDEFAULT = 
10
SW_FORCEMINIMIZE = 
11
SW_MAX = 
11

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(p_pDesktop = nil, p_strTitle = nil, p_x = nil, p_y = nil, p_width = nil, p_length = nil, p_xCountChars = nil, p_yCountChars = nil, p_fillAttribute = nil, p_showWindow = nil, p_stdin = nil, p_stdout = nil, p_stderr = nil) ⇒ StartupInfo

class methodsFor: “initialization”



117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
 
# File 'lib/Win32/Process.rb', line 117

def initialize(
		p_pDesktop = nil, p_strTitle = nil,
		p_x = nil, p_y = nil, p_width = nil, p_length = nil,
		p_xCountChars = nil, p_yCountChars = nil,
		p_fillAttribute = nil,
		p_showWindow = nil,
		p_stdin = nil, p_stdout = nil, p_stderr = nil)
	@desktop           = p_pDesktop
	@title             = p_strTitle
	@flags             = 0
	self.x             = p_x
	self.y             = p_y
	self.width         = p_width
	self.length        = p_length
	self.xCountChars   = p_xCountChars
	self.yCountChars   = p_yCountChars
	self.fillAttribute = p_fillAttribute
	self.showWindow    = p_showWindow
	self.stdin         = p_stdin
	self.stdout        = p_stdout
	self.stderr        = p_stderr
end

Instance Attribute Details

#desktop ⇒ Object (readonly)

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def desktop
  @desktop
end

#fillAttribute ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def fillAttribute
  @fillAttribute
end

#length ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def length
  @length
end

#showWindow ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def showWindow
  @showWindow
end

#stderr ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def stderr
  @stderr
end

#stdin ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def stdin
  @stdin
end

#stdout ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def stdout
  @stdout
end

#title ⇒ Object (readonly)

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def title
  @title
end

#width ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def width
  @width
end

#x ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def x
  @x
end

#xCountChars ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def xCountChars
  @xCountChars
end

#y ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def y
  @y
end

#yCountChars ⇒ Object

attributesFor: “window properties”



65
66
67
 
# File 'lib/Win32/Process.rb', line 65

def yCountChars
  @yCountChars
end

Class Method Details

.sizeof ⇒ Object

class methodsFor: “Data sizing”



111
112
113
 
# File 'lib/Win32/Process.rb', line 111

def StartupInfo.sizeof
	return 80 # 16 longs and 2 words
end

.unpack(p_pData) ⇒ Object

class methodsFor: “unpacking data”



142
143
144
145
146
147
148
149
150
151
152
 
# File 'lib/Win32/Process.rb', line 142

def StartupInfo.unpack(p_pData)
	pData = p_pData.unpack("L12S2L4")
	return StartupInfo.new(
				pData[ 1], pData[ 2],
				pData[ 3], pData[ 4], pData[ 5], pData[ 6],
				pData[ 7], pData[ 8],
				pData[ 9],
				pData[11],
				pData[14], pData[15], pData[16]
	)
end

Instance Method Details

#pack ⇒ Object

methodsFor: “packing data”



168
169
170
171
172
173
174
175
176
177
178
179
180
181
 
# File 'lib/Win32/Process.rb', line 168

def pack
	return [StartupInfo.sizeof,
			0,
			xx(@desktop),
			xx(@title),
			xx(@x), xx(@y), xx(@width), xx(@length),
			xx(@xCountChars), xx(@yCountChars),
			xx(@fillAttribute),
			xx(@flags),
			xx(@showWindow),
			0, 0,
			xx(@stdin), xx(@stdout), xx(@stderr)
			].pack('L12S2L4')
end

#to_s ⇒ Object

methodsFor: “printing”



231
232
233
234
235
236
237
238
239
240
241
242
243
 
# File 'lib/Win32/Process.rb', line 231

def to_s
	str = "["
	str += " desktop: #{@desktop}"										if nil != @desktop
	str += " title: #{@title}"											if nil != @title
	str += " x: #{@x} y: #{@y}"											if testf(STARTF_USEPOSITION)
	str += " width: #{@width} length: #{@length}"						if testf(STARTF_USESIZE)
	str += " xCountChars: #{@xCountChars} yCountChars: #{@yCountChars}"	if testf(STARTF_USECOUNTCHARS)
	str += " fillAttribute: #{@fillAttribute}"							if testf(STARTF_USEFILLATTRIBUTE)
	str += " showWindow: #{@showWindow}"								if testf(STARTF_USESHOWWINDOW)
	str += " stdin: #{@stdin} stdout: #{@stdout} stderr: #{@stderr}"	if testf(STARTF_USESTDHANDLES)
	str += " ]"
	return str
end

#xx(val) ⇒ Object 



154
155
156
157
158
159
160
161
162
163
164
 
# File 'lib/Win32/Process.rb', line 154

def xx(val)
	if RUBY_VERSION >= "1.8.2" then
		if val == nil then
			0
		else
			val
		end
	else
		val
	end
end