GuiSetPosition: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (fixed typo and error in example)
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 endicates if the x/y positions are relative to the screen size
*'''relative:''' Bool that indicates if the x/y positions are relative to the screen size


===Returns===
===Returns===
Line 33: Line 33:
guiSetText ( myLabel, elementType )
guiSetText ( myLabel, elementType )
--and place it in the position of where the element is
--and place it in the position of where the element is
guiSetPosition ( myLabel, absoluteX, absoluteY, true )
guiSetPosition ( 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 ( guiSetText, 5000, 1, myLabel, "" )
setTimer ( guiSetText, 5000, 1, myLabel, "" )

Revision as of 23:01, 1 November 2008

This function sets the position of a GUI element.

Syntax

bool guiSetPosition ( element theElement, float x, float y, bool relative )

Required Arguments

  • theElement: The GUI 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.

--create an empty label
local myLabel = guiCreateLabel  ( 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 = getElementType ( clickedElement )
		--change the label text to that element type
		guiSetText ( myLabel, elementType )
		--and place it in the position of where the element is
		guiSetPosition ( myLabel, absoluteX, absoluteY, false )
		--hide the text by passing an empty string 5 seconds later
		setTimer ( guiSetText, 5000, 1, myLabel, "" )
	end
end
addEventHandler ( "onClientClick", getRootElement(), addLabelOnClick )

See Also

General functions

Browsers

Buttons

Checkboxes

Comboboxes

Edit Boxes

Gridlists

Memos

Progressbars

Radio Buttons

Scrollbars

Scrollpanes

Static Images

Tab Panels

Tabs

Text Labels

Windows