DgsSetPosition - Revision history

Lettify: little correction

2021-04-16T18:23:57Z

little correction

← Older revision		Revision as of 18:23, 16 April 2021
Line 7:		Line 7:
	bool dgsSetPosition ( element theElement, float x, float y, bool relative [, bool isCenterPosition = false ] )		bool dgsSetPosition ( element theElement, float x, float y, bool relative [, bool isCenterPosition = false ] )
	</syntaxhighlight>		</syntaxhighlight>
	{{DGS/OOP\|The variable is a conjunction: '''position.x''' (~~get~~ X position) ~~and~~ '''position.y''' (~~get~~ Y position)\|DGSElement:setPosition\|\|position\|dgsGetPosition\|\|}}		{{DGS/OOP\|The variable is a conjunction: '''position.x''' (set X position), '''position.y''' (set Y position) and '''position.relative''' (set Relative property)\|DGSElement:setPosition\|\|position\|dgsGetPosition\|\|}}

	===Required Arguments===		===Required Arguments===

Lettify: DGS (OOP Syntax)/(Template Organization) Mission

2021-04-16T16:48:31Z

DGS (OOP Syntax)/(Template Organization) Mission

← Older revision		Revision as of 16:48, 16 April 2021
Line 7:		Line 7:
	bool dgsSetPosition ( element theElement, float x, float y, bool relative [, bool isCenterPosition = false ] )		bool dgsSetPosition ( element theElement, float x, float y, bool relative [, bool isCenterPosition = false ] )
	</syntaxhighlight>		</syntaxhighlight>
			{{DGS/OOP\|The variable is a conjunction: '''position.x''' (get X position) and '''position.y''' (get Y position)\|DGSElement:setPosition\|\|position\|dgsGetPosition\|\|}}

	===Required Arguments===		===Required Arguments===
Line 46:		Line 47:

	==See Also==		==See Also==
	<!-- ~~Change FunctionArea to the area that this function is in on the main function list page, e~~.g. ~~Server, Player, Vehicle etc --~~>
	{{~~DGSFUNCTIONS~~}}		===<span style="color:#eb3f00;text-shadow:0.05em 0.05em 0.2em #00000099;">General Functions</span>===
			{{DGS General Functions}}

			===<span style="color:#eb3f00;text-shadow:0.05em 0.05em 0.2em #00000099;">General Events</span>===
			{{DGS Events/General}}

Thisdp at 06:29, 3 August 2019

2019-08-03T06:29:44Z

← Older revision		Revision as of 06:29, 3 August 2019
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dgsSetPosition ( element theElement, float x, float y, bool relative )		bool dgsSetPosition ( element theElement, float x, float y, bool relative [, bool isCenterPosition = false ] )
	</syntaxhighlight>		</syntaxhighlight>

Line 14:		Line 14:
	*'''y:''' Position over the Y axis		*'''y:''' Position over the Y axis
	*'''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 relative to the parent.		*'''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 relative to the parent.

			===Optional Arguments===
			*'''isCenterPosition:''' A bool of whether the input x/y is the center position of a dgs element.

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

Thisdp: /* Example */

2018-01-21T03:53:33Z

Example

← Older revision		Revision as of 03:53, 21 January 2018
Line 24:		Line 24:
	DGS = exports.dgs		DGS = exports.dgs
	--create an empty label		--create an empty label
	local myLabel = DGS:~~dgsDxCreateLabel~~ ( 0, 0, 1, 1, "", true )		local myLabel = DGS:dgsCreateLabel ( 0, 0, 1, 1, "", true )

	function addLabelOnClick ( button, state, absoluteX, absoluteY, worldX, worldY, worldZ, clickedElement )		function addLabelOnClick ( button, state, absoluteX, absoluteY, worldX, worldY, worldZ, clickedElement )
Line 32:		Line 32:
	local elementType = DGS:dgsGetType ( clickedElement )		local elementType = DGS:dgsGetType ( clickedElement )
	--change the label text to that element type		--change the label text to that element type
	DGS:~~dgsDxGUISetText~~ ( myLabel, elementType )		DGS:dgsSetText ( myLabel, elementType )
	--and place it in the position of where the element is		--and place it in the position of where the element is
	DGS:dgsSetPosition ( myLabel, absoluteX, absoluteY, false )		DGS:dgsSetPosition ( myLabel, absoluteX, absoluteY, false )
	--hide the text by passing an empty string 5 seconds later		--hide the text by passing an empty string 5 seconds later
	setTimer ( DGS:~~dgsDxGUISetText~~, 5000, 1, myLabel, "" )		setTimer ( DGS:dgsSetText, 5000, 1, myLabel, "" )
	end		end
	end		end
	addEventHandler ( "~~onClientDgsDxMouseClick~~", getRootElement(), addLabelOnClick )		addEventHandler ( "onDgsMouseClick", getRootElement(), addLabelOnClick )
	</syntaxhighlight>		</syntaxhighlight>

Thisdp at 14:16, 18 January 2018

2018-01-18T14:16:58Z

← Older revision		Revision as of 14:16, 18 January 2018
Line 13:		Line 13:
	*'''x:''' Position over the X axis		*'''x:''' Position over the X axis
	*'''y:''' Position over the Y axis		*'''y:''' Position over the Y axis
	*'''relative:''' ~~Bool that indicates if the~~ x/y ~~positions are~~ relative to the ~~screen size~~		*'''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 relative to the parent.

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

Thisdp: Thisdp moved page Dgs/DgsSetPosition to DgsSetPosition

2017-07-02T02:07:55Z

Thisdp moved page Dgs/DgsSetPosition to DgsSetPosition

← Older revision

Revision as of 02:07, 2 July 2017

Thisdp: Created page with "{{Client function}} NOTOC This function sets the position of a DGS element. ==Syntax== bool dgsSetPosition ( element theElement, float x, fl..."

2017-06-09T15:11:16Z

Created page with "{{Client function}} __NOTOC__ This function sets the position of a DGS element. ==Syntax== <syntaxhighlight lang="lua"> bool dgsSetPosition ( element theElement, float x, fl..."

New page

{{Client function}}
__NOTOC__
This function sets the position of a DGS element.

==Syntax==
<syntaxhighlight lang="lua">
bool dgsSetPosition ( element theElement, float x, float y, bool relative )
</syntaxhighlight>

===Required Arguments===

*'''theElement:''' The DGS element to change position for
*'''x:''' Position over the X axis
*'''y:''' Position over the Y axis
*'''relative:''' Bool that indicates if the x/y positions are relative to the screen size

===Returns===

Returns ''true'' if the position has been successfully set, ''false'' otherwise.

==Example==
This example creates a label. When an element is clicked, the label displays in the position of the element telling you what kind of element you have clicked. It hides after 5 seconds.
<syntaxhighlight lang="lua">
DGS = exports.dgs
--create an empty label
local myLabel = DGS:dgsDxCreateLabel ( 0, 0, 1, 1, "", true )

function addLabelOnClick ( button, state, absoluteX, absoluteY, worldX, worldY, worldZ, clickedElement )
--if an element was clicked on screen
if ( clickedElement ) then
--retreive the element type
local elementType = DGS:dgsGetType ( clickedElement )
--change the label text to that element type
DGS:dgsDxGUISetText ( myLabel, elementType )
--and place it in the position of where the element is
DGS:dgsSetPosition ( myLabel, absoluteX, absoluteY, false )
--hide the text by passing an empty string 5 seconds later
setTimer ( DGS:dgsDxGUISetText, 5000, 1, myLabel, "" )
end
end
addEventHandler ( "onClientDgsDxMouseClick", getRootElement(), addLabelOnClick )
</syntaxhighlight>

==See Also==

{{DGSFUNCTIONS}}