DgsCreateWindow - Revision history

Lettify: fix mistake

2021-04-21T15:14:08Z

fix mistake

XLive: update argument names

2021-02-16T10:32:03Z

update argument names

← Older revision		Revision as of 10:32, 16 February 2021
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	element dgsCreateWindow ( float x, float y, float width, float height, string ~~titleBarText~~, bool relative[, int ~~titlenamecolor~~ = 0xFFFFFFFF, float ~~titsize~~ = 25, element ~~titimg~~ = nil, int ~~titcolor~~ = 0xC8141414, element ~~bgimg~~ = nil, int ~~bgcolor~~ = 0x96141414, float ~~sidesize~~ = 5, bool ~~nooffbutton~~ = false ] )		element dgsCreateWindow ( float x, float y, float width, float height, string text, bool relative[, int textColor = 0xFFFFFFFF, float titleHeight = 25, element titleImage = nil, int titleColor = 0xC8141414, element image = nil, int color = 0x96141414, float borderSize = 5, bool noCloseButton = false ] )
	</syntaxhighlight>		</syntaxhighlight>

Line 14:		Line 14:
	*'''width:''' A float of the width of the window. This is affected by the ''relative'' argument.		*'''width:''' A float of the width of the window. This is affected by the ''relative'' argument.
	*'''height:''' A float of the height of the window. This is affected by the ''relative'' argument.		*'''height:''' A float of the height of the window. This is affected by the ''relative'' argument.
	*'''~~titleBarText~~:''' A string of the text that will be displayed in the title bar of the window.		*'''text:''' A string of the text that will be displayed in the title bar of the window.
	*'''relative:''' This is whether sizes and positioning are relative. If this is ''true'', then all x,y,width,height floats must be between 0 and 1, representing sizes/positions as a fraction of the screen size. If ''false'', then the size and co-ordinates are based on client's resolution, accessible using [[guiGetScreenSize]].		*'''relative:''' This is whether sizes and positioning are relative. If this is ''true'', then all x,y,width,height floats must be between 0 and 1, representing sizes/positions as a fraction of the screen size. If ''false'', then the size and co-ordinates are based on client's resolution, accessible using [[guiGetScreenSize]].

	===Optional Arguments===		===Optional Arguments===
	{{OptionalArg}}		{{OptionalArg}}
	*'''~~titlenamecolor~~:''' An int of the color of the title text of the window.		*'''textColor:''' An int of the color of the title text of the window.
	*'''~~titsize~~:''' A float of the height of the title of the window.		*'''titleHeight:''' A float of the height of the title of the window.
	*'''~~titimg~~:''' A texture element of the background of the title of the window.		*'''titleImage:''' A texture element of the background of the title of the window.
	*'''~~titcolor~~:''' An int of the color of the title of the window.		*'''titleColor:''' An int of the color of the title of the window.
	*'''~~bgimg~~:''' A texture element of the background of the body of the window.		*'''image:''' A texture element of the background of the body of the window.
	*'''~~bgcolor~~:''' An int of the background color of the body of the window.		*'''color:''' An int of the background color of the body of the window.
	*'''~~sidesize~~:''' A float of the side of the window that affects window sizing.		*'''borderSize:''' A float of the side of the window that affects window sizing.
	*'''~~nooffbutton~~ :''' A bool of whether the window is created without close button.		*'''noCloseButton:''' A bool of whether the window is created without close button.

	===Returns===		===Returns===

Thisdp: Thisdp moved page DgsDxCreateWindow to DgsCreateWindow

2018-01-20T11:00:43Z

Thisdp moved page DgsDxCreateWindow to DgsCreateWindow

← Older revision

Revision as of 11:00, 20 January 2018

Thisdp at 10:59, 20 January 2018

2018-01-20T10:59:51Z

Ahmed Ly at 07:51, 24 August 2017

2017-08-24T07:51:34Z

← Older revision		Revision as of 07:51, 24 August 2017
Line 9:		Line 9:

	===Required Arguments===		===Required Arguments===
	[[Image:~~gui-window~~.~~png~~\|frame\|Example Window.]]		[[Image:Dx_6.PNG\|frame\|Example Dx Window.]]
	*'''x:''' A float of the 2D x position of the window on a player's screen. This is affected by the ''relative'' argument.		*'''x:''' A float of the 2D x position of the window on a player's screen. This is affected by the ''relative'' argument.
	*'''y:''' A float of the 2D y position of the window on a player's screen. This is affected by the ''relative'' argument.		*'''y:''' A float of the 2D y position of the window on a player's screen. This is affected by the ''relative'' argument.

Thisdp: /* Example */

2017-07-02T02:09:45Z

Example

← Older revision		Revision as of 02:09, 2 July 2017
Line 33:		Line 33:
	==Example==		==Example==
	This example creates a weapon selection screen, complete with a window, gridlist and a button. Users can select a shotgun or a machine gun. The window is not movable or sizable.		This example creates a weapon selection screen, complete with a window, gridlist and a button. Users can select a shotgun or a machine gun. The window is not movable or sizable.
	<syntaxhighlight lang="lua~~" class="client~~">		<syntaxhighlight lang="lua">
	DGS = exports.dgs --get exported functions from dgs		DGS = exports.dgs --get exported functions from dgs
	--Setup some tables		--Setup some tables

Thisdp: /* Example */

2017-07-02T02:09:37Z

Example

← Older revision		Revision as of 02:09, 2 July 2017
Line 33:		Line 33:
	==Example==		==Example==
	This example creates a weapon selection screen, complete with a window, gridlist and a button. Users can select a shotgun or a machine gun. The window is not movable or sizable.		This example creates a weapon selection screen, complete with a window, gridlist and a button. Users can select a shotgun or a machine gun. The window is not movable or sizable.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua" class="client">
	DGS = exports.dgs --get exported functions from dgs		DGS = exports.dgs --get exported functions from dgs
	--Setup some tables		--Setup some tables

Thisdp: Thisdp moved page Dgs/DgsDxCreateWindow to DgsDxCreateWindow

2017-07-02T01:59:44Z

Thisdp moved page Dgs/DgsDxCreateWindow to DgsDxCreateWindow

← Older revision

Revision as of 01:59, 2 July 2017

Thisdp: /* Syntax */

2017-06-08T05:58:00Z

Syntax

← Older revision		Revision as of 05:58, 8 June 2017
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	element dgsDxCreateWindow ( float x, float y, float width, float height, string titleBarText, bool relative[, int titlenamecolor = 0xFFFFFFFF, float titsize = 25, element titimg = nil, int titcolor = ~~0x141414C8~~, element bgimg = nil, int bgcolor = ~~0x14141496~~, float sidesize = 5, bool nooffbutton = false ] )		element dgsDxCreateWindow ( float x, float y, float width, float height, string titleBarText, bool relative[, int titlenamecolor = 0xFFFFFFFF, float titsize = 25, element titimg = nil, int titcolor = 0xC8141414, element bgimg = nil, int bgcolor = 0x96141414, float sidesize = 5, bool nooffbutton = false ] )
	</syntaxhighlight>		</syntaxhighlight>

Thisdp: /* Syntax */

2017-06-03T04:27:54Z

Syntax

← Older revision		Revision as of 04:27, 3 June 2017
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	element dgsDxCreateWindow ( float x, float y, float width, float height, string titleBarText, bool relative[, int titlenamecolor = 0xFFFFFFFF, float titsize = 25, element titimg = nil, int titcolor = 0x141414C8, element bgimg = nil, int bgcolor = 0x14141496, float sidesize = 5, bool nooffbutton = false] )		element dgsDxCreateWindow ( float x, float y, float width, float height, string titleBarText, bool relative[, int titlenamecolor = 0xFFFFFFFF, float titsize = 25, element titimg = nil, int titcolor = 0x141414C8, element bgimg = nil, int bgcolor = 0x14141496, float sidesize = 5, bool nooffbutton = false ] )
	</syntaxhighlight>		</syntaxhighlight>

← Older revision		Revision as of 15:14, 21 April 2021
Line 34:		Line 34:
	This example creates a weapon selection screen, complete with a window, gridlist and a button. Users can select a shotgun or a machine gun. The window is not movable or sizable.		This example creates a weapon selection screen, complete with a window, gridlist and a button. Users can select a shotgun or a machine gun. The window is not movable or sizable.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~DGS =~~ exports.dgs ~~--get exported functions from dgs~~		loadstring(exports.dgs:dgsImportFunction())()

	--Setup some tables		--Setup some tables

	shotguns = {		shotguns = {
	"chrome",		"chrome",
Line 51:		Line 51:
	-- getResourceRootElement(getThisResource()) at the bottom means it will only create the gui on this resource start		-- getResourceRootElement(getThisResource()) at the bottom means it will only create the gui on this resource start
	-- Create a window for our spawnscreen, with the title "Select your weapons".		-- Create a window for our spawnscreen, with the title "Select your weapons".
	spawnScreenMenu = ~~DGS:~~dgsCreateWindow ( 0.15, 0.33, 0.7, 0.34, "Select your weapons", true )		spawnScreenMenu = dgsCreateWindow ( 0.15, 0.33, 0.7, 0.34, "Select your weapons", true )
	-- create an OK button to allow the user to confirm their selections, and attach it to the confirmSelection function		-- create an OK button to allow the user to confirm their selections, and attach it to the confirmSelection function
	spawnScreenOKButton = ~~DGS:~~dgsCreateButton ( 0.4, 0.85, 0.20, 0.15, "OK", true, spawnScreenMenu )		spawnScreenOKButton = dgsCreateButton ( 0.4, 0.85, 0.20, 0.15, "OK", true, spawnScreenMenu )
	-- ensure the user can't move or resize our spawnscreen.		-- ensure the user can't move or resize our spawnscreen.
	~~DGS:~~dgsWindowSetMovable ( spawnScreenMenu, false )		dgsWindowSetMovable ( spawnScreenMenu, false )
	~~DGS:~~dgsWindowSetSizable ( spawnScreenMenu, false )		dgsWindowSetSizable ( spawnScreenMenu, false )
	-- create our gridlist, which fills up most of the window.		-- create our gridlist, which fills up most of the window.
	spawnScreenGridList = ~~DGS:~~dgsCreateGridList ( 0, 0.1, 1, 0.9, true, spawnScreenMenu )		spawnScreenGridList = dgsCreateGridList ( 0, 0.1, 1, 0.9, true, spawnScreenMenu )
	-- Since we have 2 sets of weapons, create a column for shotguns and one for machine guns		-- Since we have 2 sets of weapons, create a column for shotguns and one for machine guns
	~~DGS:~~dgsGridListAddColumn ( spawnScreenGridList, "Shotguns", 0.3 )		dgsGridListAddColumn ( spawnScreenGridList, "Shotguns", 0.3 )
	~~DGS:~~dgsGridListAddColumn ( spawnScreenGridList, "Machine guns", 0.3 )		dgsGridListAddColumn ( spawnScreenGridList, "Machine guns", 0.3 )
	-- next, we loop through our handguns table to add handgun items to the gridlist		-- next, we loop through our handguns table to add handgun items to the gridlist
	for key,weaponName in pairs(shotguns) do		for key,weaponName in pairs(shotguns) do
	-- add a new row to our gridlist each time		-- add a new row to our gridlist each time
	local row = ~~DGS:~~dgsGridListAddRow ( spawnScreenGridList )		local row = dgsGridListAddRow ( spawnScreenGridList )
	-- next, we set that row's text to the weapon name. Column is 1 since the "Shotguns" column was created first.		-- next, we set that row's text to the weapon name. Column is 1 since the "Shotguns" column was created first.
	~~DGS:~~dgsGridListSetItemText ( spawnScreenGridList, row, 1, weaponName )		dgsGridListSetItemText ( spawnScreenGridList, row, 1, weaponName )
	end		end
	-- we repeat the process for other weapon list, changing the column number		-- we repeat the process for other weapon list, changing the column number
	row = 0		row = 1
	for key,weaponName in pairs(machineGun) do		for key,weaponName in pairs(machineGun) do
	-- we don't need to create new rows as that was done in the previous loop		-- we don't need to create new rows as that was done in the previous loop
	-- we just set the row's text to the weapon name. Column is 2 since the "Machine guns" column was created second.		-- we just set the row's text to the weapon name. Column is 2 since the "Machine guns" column was created second.
	~~DGS:~~dgsGridListSetItemText ( spawnScreenGridList, row, 2, weaponName )		dgsGridListSetItemText ( spawnScreenGridList, row, 2, weaponName )
	row = row + 1 -- increase the row number		row = row + 1 -- increase the row number
	end		end

← Older revision		Revision as of 10:59, 20 January 2018
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	element ~~dgsDxCreateWindow~~ ( float x, float y, float width, float height, string titleBarText, bool relative[, int titlenamecolor = 0xFFFFFFFF, float titsize = 25, element titimg = nil, int titcolor = 0xC8141414, element bgimg = nil, int bgcolor = 0x96141414, float sidesize = 5, bool nooffbutton = false ] )		element dgsCreateWindow ( float x, float y, float width, float height, string titleBarText, bool relative[, int titlenamecolor = 0xFFFFFFFF, float titsize = 25, element titimg = nil, int titcolor = 0xC8141414, element bgimg = nil, int bgcolor = 0x96141414, float sidesize = 5, bool nooffbutton = false ] )
	</syntaxhighlight>		</syntaxhighlight>

Line 51:		Line 51:
	-- getResourceRootElement(getThisResource()) at the bottom means it will only create the gui on this resource start		-- getResourceRootElement(getThisResource()) at the bottom means it will only create the gui on this resource start
	-- Create a window for our spawnscreen, with the title "Select your weapons".		-- Create a window for our spawnscreen, with the title "Select your weapons".
	spawnScreenMenu = DGS:~~dgsDxCreateWindow~~ ( 0.15, 0.33, 0.7, 0.34, "Select your weapons", true )		spawnScreenMenu = DGS:dgsCreateWindow ( 0.15, 0.33, 0.7, 0.34, "Select your weapons", true )
	-- create an OK button to allow the user to confirm their selections, and attach it to the confirmSelection function		-- create an OK button to allow the user to confirm their selections, and attach it to the confirmSelection function
	spawnScreenOKButton = DGS:~~dgsDxCreateButton~~ ( 0.4, 0.85, 0.20, 0.15, "OK", true, spawnScreenMenu )		spawnScreenOKButton = DGS:dgsCreateButton ( 0.4, 0.85, 0.20, 0.15, "OK", true, spawnScreenMenu )
	-- ensure the user can't move or resize our spawnscreen.		-- ensure the user can't move or resize our spawnscreen.
	DGS:~~dgsDxWindowSetMovable~~ ( spawnScreenMenu, false )		DGS:dgsWindowSetMovable ( spawnScreenMenu, false )
	DGS:~~dgsDxWindowSetSizable~~ ( spawnScreenMenu, false )		DGS:dgsWindowSetSizable ( spawnScreenMenu, false )
	-- create our gridlist, which fills up most of the window.		-- create our gridlist, which fills up most of the window.
	spawnScreenGridList = DGS:~~dgsDxCreateGridList~~ ( 0, 0.1, 1, 0.9, true, spawnScreenMenu )		spawnScreenGridList = DGS:dgsCreateGridList ( 0, 0.1, 1, 0.9, true, spawnScreenMenu )
	-- Since we have 2 sets of weapons, create a column for shotguns and one for machine guns		-- Since we have 2 sets of weapons, create a column for shotguns and one for machine guns
	DGS:~~dgsDxGridListAddColumn~~ ( spawnScreenGridList, "Shotguns", 0.3 )		DGS:dgsGridListAddColumn ( spawnScreenGridList, "Shotguns", 0.3 )
	DGS:~~dgsDxGridListAddColumn~~ ( spawnScreenGridList, "Machine guns", 0.3 )		DGS:dgsGridListAddColumn ( spawnScreenGridList, "Machine guns", 0.3 )
	-- next, we loop through our handguns table to add handgun items to the gridlist		-- next, we loop through our handguns table to add handgun items to the gridlist
	for key,weaponName in pairs(shotguns) do		for key,weaponName in pairs(shotguns) do
	-- add a new row to our gridlist each time		-- add a new row to our gridlist each time
	local row = DGS:~~dgsDxGridListAddRow~~ ( spawnScreenGridList )		local row = DGS:dgsGridListAddRow ( spawnScreenGridList )
	-- next, we set that row's text to the weapon name. Column is 1 since the "Shotguns" column was created first.		-- next, we set that row's text to the weapon name. Column is 1 since the "Shotguns" column was created first.
	DGS:~~dgsDxGridListSetItemText~~ ( spawnScreenGridList, row, 1, weaponName )		DGS:dgsGridListSetItemText ( spawnScreenGridList, row, 1, weaponName )
	end		end
	-- we repeat the process for other weapon list, changing the column number		-- we repeat the process for other weapon list, changing the column number
Line 74:		Line 74:
	-- we don't need to create new rows as that was done in the previous loop		-- we don't need to create new rows as that was done in the previous loop
	-- we just set the row's text to the weapon name. Column is 2 since the "Machine guns" column was created second.		-- we just set the row's text to the weapon name. Column is 2 since the "Machine guns" column was created second.
	DGS:~~dgsDxGridListSetItemText~~ ( spawnScreenGridList, row, 2, weaponName )		DGS:dgsGridListSetItemText ( spawnScreenGridList, row, 2, weaponName )
	row = row + 1 -- increase the row number		row = row + 1 -- increase the row number
	end		end
Line 83:		Line 83:
	==See Also==		==See Also==
	{{DGSFUNCTIONS}}		{{DGSFUNCTIONS}}
	[[ZH-CN:~~dgsDxCreateWindow~~]]		[[ZH-CN:dgsCreateWindow]]