DgsMemoMoveCaret: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
Line 34: Line 34:


==See Also==
==See Also==
{{GUI_functions}}
{{DGSFUNCTIONS}}

Revision as of 08:55, 2 December 2017

This function sets the current position of the caret (the text cursor) within the edit box.

Syntax

bool guiEditSetCaretIndex ( element theElement, int indexoffset [, int lineoffset = 0, bool selectText = false, bool noChangeLine = false ] )

Required Arguments

  • theElement: The edit box to be changed.
  • indexoffset: An integer indicated how many indexes will the cursor move within the box.

Optional Arguments

  • lineoffset: An integer indicated how many lines will the cursor move within the box.
  • selectText: A bool indicated whether this movement will select text.
  • noChangeLine: A bool indicated whether this movement won't jump to another line.

Returns

Returns true if the index was successfully set, false otherwise.

Example

This example makes the text cursor jump to the end of an edit box if the user is holding the Left Control button.

function moveToEndOnClick()
	if ( getKeyState ( "lctrl" ) == true ) and ( getElementType(source) == "gui-edit" ) then          -- if the user is holding down left control
		local text = guiGetText ( source )
		local textLength = string.len ( text )
		guiEditSetCaretIndex ( source, textLength )  -- set the caret index. No need to check if the clicked control is actually an edit box as this function won't work on other controls anyway
	end
end
addEventHandler ( "onClientGUIClick", getRootElement(), moveToEndOnClick )    -- add an event handler for clicks

See Also

Custom Cursor Functions

Multi Language Supports

Animation

3D Element

3D Interface

3D Line

3D Image

3D Text

Browser

Button

Check Box

Combo Box

Custom Renderer

Edit

Detect Area

Drag'N Drop

Grid List

Image

Memo

Menu

Label

Layout

Line

Progress Bar

Radio Button

Scale Pane

Scroll Bar

Scroll Pane

Selector

Style

Switch Button

Tab Panel

Window

Basic Shape Plugins

Circle

Quadrilateral

Rounded Rectangle

Other Plugins

Blur Box

Canvas

Chart

Color Picker

Effect 3D

Gradient

Mask

Media Browser

Nine Slice

Object Preview Supports

Paste Handler

QRCode

Remote Image

Screen Source

SVG

Tooltips