Multi Theft Auto: Wiki - User contributions [en]

PT-BR/dxGetTextSize

2021-05-06T12:21:37Z

Fogtz:

__NOTOC__
{{BR/Funcao cliente}}
{{New items|3.0158|1.5.7|Esta função ira retornar a largura e altura teóricas (em pixels) de um determinado trecho de texto, se ele fosse feito usando [[dxDrawText]].|20447}}

'''NOTA:''' Esta função já leva em consideração a resolução da tela do cliente.

==Syntax==
<syntaxhighlight lang="lua">
float, float dxGetTextSize ( string text [, float width = 0, float scaleX = 1.0, float scaleY = 1.0, mixed font = "default", bool wordBreak = false, bool colorCoded = false] )
</syntaxhighlight>
{{BR/OOP|Esta sintaxe requer que você ignore o argumento da fonte acima| [[Element/DX font|font]]:getSize}}
==Argumentos Requeridos==
* '''texto:''' Uma string que representa o texto para o qual você deseja recuperar com largura.

==Argumentos Opcionais==
{{BR/ArgOpcional}}
* '''width:''' A largura do texto. Usar com ''wordBreak = true''.
* '''scaleX:''' O tamanho do texto. O tamanho também pode ser inserida como um [[Vector2]].
* '''scaleY:''' O tamanho do texto.
* '''fonte:''' Ou uma [[DX font|Fonte Dx]] elemento ou o nome de uma fonte dx integrada:
{{DxFonts}}
* '''wordBreak:''' Se definido para ''true'', o texto será quebrado em uma nova linha sempre que atingir o lado direito da caixa delimitadora. Se ''false'', o texto sempre estará completamente em uma linha.
* '''colorCoded:''' Devemos excluir códigos de cores da largura? False incluirá o hexadecimal no comprimento.

===Retorna===
Retorna dois '''floats''' que representam a largura e a altura do texto em pixels.

==Exemplo==
<section name="Exemplo 1" class="client" show="true">
Esse exemplo mostra um retângulo que acompanha o texto digitado após o comando ser acionado
<syntaxhighlight lang="lua">
local screenWidth, screenHeight = guiGetScreenSize() -- Pegamos a resolução do cliente
local PosX, PosY = (screenWidth/1360), (screenHeight/768) -- Resolução do desenvolvedor do script
local boxIsShowing = false -- Definimos que a variavel é false

function theMessageBox()
if boxIsShowing and Texto then
local textoWidth, textoHeight = dxGetTextSize(Texto, PosX * (160 - 15), 1, 1, "default-bold", true, false) -- Pegamos os dois floats que dxGetTextSize retorna

--[[ Uma nota importante é que o PosX * (160 - 15) acima vai representar:

160 = 4° Parametro do dxDrawText, representa largura do texto ;
15 = 2° Parametro do dxDrawText, representa " Posição X " do texto.

Para retornar a altura sempre use o wordbreak como true

]]--

dxDrawRectangle(PosX * 5, PosY * 350, PosX * 170, textoHeight + 15, tocolor(13, 13, 13, 180), false) -- Colocamos o retangulo para aumentar conforme a altura do texto
dxDrawText(Texto, PosX * 15, PosY * 358, PosX * 160, PosY * 380, tocolor(255, 255, 255, 255), 1.00, "default-bold", "left", "top", false, true, false, false, false)
end
end

addCommandHandler("showbox", function(nomeDoComando, ...)
if not boxIsShowing then
local Mensagem = table.concat({...}, " ")
if Mensagem ~= "" then
Texto = Mensagem
boxIsShowing = true
addEventHandler("onClientRender", root, theMessageBox)
setTimer(function()
boxIsShowing = false
Texto = nil
removeEventHandler("onClientRender", root, theMessageBox)
end, 10 * 1000, 1)
else
outputChatBox("Você precisa digitar uma mensagem após o comando.", 255, 255, 255, true)
end
end
end)
</syntaxhighlight>
[[File:PT-BR-dxGetTextSize.png|thumb|none]]
</section>
==Requer==
{{PT-BR/Requerimentos|N/A|1.5.7-9.20447|}}

==Veja Mais==

{{Drawing_functions}}

PT-BR/dxGetTextSize

2021-05-05T19:49:03Z

Fogtz: Translated to PT-BR

__NOTOC__
{{BR/Funcao cliente}}
{{New items|3.0158|1.5.7|Esta função ira retornar a largura e altura teóricas (em pixels) de um determinado trecho de texto, se ele fosse feito usando [[dxDrawText]].|20447}}

'''NOTA:''' Esta função já leva em consideração a resolução da tela do cliente.

==Syntax==
<syntaxhighlight lang="lua">
float, float dxGetTextSize ( string text [, float width = 0, float scaleX = 1.0, float scaleY = 1.0, mixed font = "default", bool wordBreak = false, bool colorCoded = false] )
</syntaxhighlight>
{{BR/OOP|Esta sintaxe requer que você ignore o argumento da fonte acima| [[Element/DX font|font]]:getSize}}
==Argumentos Requeridos==
* '''texto:''' Uma string que representa o texto para o qual você deseja recuperar com largura.

==Argumentos Opcionais==
{{BR/ArgOpcional}}
* '''width:''' A largura do texto. Usar com ''wordBreak = true''.
* '''scaleX:''' O tamanho do texto. O tamanho também pode ser inserida como um [[Vector2]].
* '''scaleY:''' O tamanho do texto.
* '''fonte:''' Ou uma [[DX font|Fonte Dx]] elemento ou o nome de uma fonte dx integrada:
{{DxFonts}}
* '''wordBreak:''' Se definido para ''true'', o texto será quebrado em uma nova linha sempre que atingir o lado direito da caixa delimitadora. Se ''false'', o texto sempre estará completamente em uma linha.
* '''colorCoded:''' Devemos excluir códigos de cores da largura? False incluirá o hexadecimal no comprimento.

===Retorna===
Retorna dois '''floats''' que representam a largura e a altura do texto em pixels.

==Exemplo==
Esse exemplo mostra um retângulo que acompanha o texto digitado após o comando ser acionado
<syntaxhighlight lang="lua">
local screenWidth, screenHeight = guiGetScreenSize() -- Pegamos a resolução do cliente
local PosX, PosY = (screenWidth/1360), (screenHeight/768) -- Resolução do desenvolvedor do script
local boxIsShowing = false -- Definimos que a variavel é false

function theMessageBox()
if boxIsShowing and Texto then
local textoWidth, textoHeight = dxGetTextSize(Texto, PosX * (160 - 15), 1, 1, "default-bold", true, false) -- Pegamos os dois floats que dxGetTextSize retorna

--[[ Uma nota importante é que o PosX * (160 - 15) acima vai representar:

160 = 4° Parametro do dxDrawText, representa largura do texto ;
15 = 2° Parametro do dxDrawText, representa " Posição X " do texto.

Para retornar a altura sempre use o wordbreak como true

]]--

dxDrawRectangle(PosX * 5, PosY * 350, PosX * 170, textoHeight + 15, tocolor(13, 13, 13, 180), false) -- Colocamos o retangulo para aumentar conforme a altura do texto
dxDrawText(Texto, PosX * 15, PosY * 358, PosX * 160, PosY * 380, tocolor(255, 255, 255, 255), 1.00, "default-bold", "left", "top", false, true, false, false, false)
end
end

addCommandHandler("showbox", function(nomeDoComando, ...)
if not boxIsShowing then
local Mensagem = table.concat({...}, " ")
if Mensagem ~= "" then
Texto = Mensagem
boxIsShowing = true
addEventHandler("onClientRender", root, theMessageBox)
setTimer(function()
boxIsShowing = false
Texto = nil
removeEventHandler("onClientRender", root, theMessageBox)
end, 10 * 1000, 1)
else
outputChatBox("Você precisa digitar uma mensagem após o comando.", 255, 255, 255, true)
end
end
end)
</syntaxhighlight>

[[File:PT-BR-dxGetTextSize.png|thumb]]

==Requer==
{{PT-BR/Requerimentos|N/A|1.5.7-9.20447|}}

==Veja Mais==

{{Drawing_functions}}

File:PT-BR-dxGetTextSize.png

2021-05-05T19:40:21Z

Fogtz:

Esse é um exemplo em portugues do dxGetTextSize

Template:PT-BR/Requerimentos

2021-05-05T19:30:01Z

Fogtz: Created page with "{| cellpadding="4" style="border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #FFF" |- !style="background-color: #FFAA44; border-style: solid; bor..."

{| cellpadding="4" style="border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #FFF"
|-
!style="background-color: #FFAA44; border-style: solid; border-width: 1px; border-color: #FFF; color:#7A4A20"| Servidor mínimo suportado
!width=60 style="white-space: nowrap; background-color: #FFCC66; border-style: solid; border-width: 1px; border-color: #FFF"| {{{1}}}
|-
!style="background-color: #FF6666; border-style: solid; border-width: 1px; border-color: #FFF; color:#AA0028"| Cliente mínimo suportado
!style="white-space: nowrap; background-color: #FFBBBB; border-style: solid; border-width: 1px; border-color: #FFF"| {{{2}}}
|}'''Nota:''' O uso desta função / evento requer que o recurso tenha a versão mínima acima declarada na seção [[Meta.xml|meta.xml]] '''<min_mta_version>'''. ''e.g. <min_mta_version {{#ifeq: {{{1}}} |n/a|server="{{{1}}}"}} {{#ifeq: {{{2}}} |n/a||client="{{{2}}}"}} />''

PT-BR/dxGetTextSize

2021-05-05T19:20:45Z

Fogtz: Created page with "__NOTOC__ {{BR/Funcao cliente}} {{New items|3.0158|1.5.7|Esta função ira retornar a largura e altura teóricas (em pixels) de um determinado trecho de texto, se ele fosse..."

__NOTOC__
{{BR/Funcao cliente}}
{{New items|3.0158|1.5.7|Esta função ira retornar a largura e altura teóricas (em pixels) de um determinado trecho de texto, se ele fosse feito usando [[dxDrawText]].|20447}}

'''NOTA:''' Esta função já leva em consideração a resolução da tela do cliente.

==Syntax==
<syntaxhighlight lang="lua">
float, float dxGetTextSize ( string text [, float width = 0, float scaleX = 1.0, float scaleY = 1.0, mixed font = "default", bool wordBreak = false, bool colorCoded = false] )
</syntaxhighlight>
{{BR/OOP|Esta sintaxe requer que você ignore o argumento da fonte acima| [[Element/DX font|font]]:getSize}}
==Argumentos Requeridos==
* '''texto:''' Uma string que representa o texto para o qual você deseja recuperar com largura.

==Argumentos Opcionais==
{{BR/ArgOpcional}}
* '''width:''' A largura do texto. Usar com ''wordBreak = true''.
* '''scaleX:''' O tamanho do texto. O tamanho também pode ser inserida como um [[Vector2]].
* '''scaleY:''' O tamanho do texto.
* '''fonte:''' Ou uma [[DX font|Fonte Dx]] elemento ou o nome de uma fonte dx integrada:
{{DxFonts}}
* '''wordBreak:''' Se definido para ''true'', o texto será quebrado em uma nova linha sempre que atingir o lado direito da caixa delimitadora. Se ''false'', o texto sempre estará completamente em uma linha.
* '''colorCoded:''' Devemos excluir códigos de cores da largura? False incluirá o hexadecimal no comprimento.

===Retorna===
Retorna dois '''floats''' que representam a largura e a altura do texto em pixels.

==Exemplo==
Esse exemplo mostra um retângulo que acompanha o texto digitado após o comando ser acionado
<syntaxhighlight lang="lua">
local screenWidth, screenHeight = guiGetScreenSize() -- Pegamos a resolução do cliente
local PosX, PosY = (screenWidth/1360), (screenHeight/768) -- Resolução do desenvolvedor do script
local boxIsShowing = false -- Definimos que a variavel é false

function theMessageBox()
if boxIsShowing and Texto then
local textoWidth, textoHeight = dxGetTextSize(Texto, PosX * (160 - 15), 1, 1, "default-bold", true, false) -- Pegamos os dois floats que dxGetTextSize retorna

--[[ Uma nota importante é que o PosX * (160 - 15) acima vai representar:

160 = 4° Parametro do dxDrawText, representa largura do texto ;
15 = 2° Parametro do dxDrawText, representa " Posição X " do texto.

Para retornar a altura sempre use o wordbreak como true

]]--

dxDrawRectangle(PosX * 5, PosY * 350, PosX * 170, textoHeight + 15, tocolor(13, 13, 13, 180), false) -- Colocamos o retangulo para aumentar conforme a altura do texto
dxDrawText(Texto, PosX * 15, PosY * 358, PosX * 160, PosY * 380, tocolor(255, 255, 255, 255), 1.00, "default-bold", "left", "top", false, true, false, false, false)
end
end

addCommandHandler("showbox", function(nomeDoComando, ...)
if not boxIsShowing then
local Mensagem = table.concat({...}, " ")
if Mensagem ~= "" then
Texto = Mensagem
boxIsShowing = true
addEventHandler("onClientRender", root, theMessageBox)
setTimer(function()
boxIsShowing = false
Texto = nil
removeEventHandler("onClientRender", root, theMessageBox)
end, 10 * 1000, 1)
else
outputChatBox("Você precisa digitar uma mensagem após o comando.", 255, 255, 255, true)
end
end
end)
</syntaxhighlight>

[[File:DxGetTextSize.png|frame|none|Um exemplo]]

==Requer==
{{PT-BR/Requerimentos|N/A|1.5.7-9.20447|}}

==Veja Mais==
{{Drawing_functions}}