Studio ManualAPI ReferenceVideo TutorialSample

Button

Button

ν΄λΌμ΄μ–ΈνŠΈμ—μ„œ μ‚¬μš©λ˜λŠ” Widget Button 객체.

이벀트

OnPressEvent

λ²„νŠΌμ΄ 눌릴 λ•Œ ν˜ΈμΆœλ˜λŠ” μ΄λ²€νŠΈμ—μš”. μ—°κ²°ν•¨μˆ˜ ν˜•μ‹μ€ function(pressButton), pressButton λŠ” 눌린 μœ„μ ―λ²„νŠΌ 객체 μž…λ‹ˆλ‹€.

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button

local function PressEvent(self) --OnPressEvent둜 μ—°κ²°λœ ν•¨μˆ˜λŠ” self μΈμžκ°€ κ³ μ •μ μœΌλ‘œ λ“€μ–΄κ°€μš”.
    print(self.Name .. " Button Click!")
end
button.OnPressEvent:Connect(PressEvent) --λ²„νŠΌμ— ν•΄λ‹Ή λ²„νŠΌμ΄ λˆŒλ Έμ„λ•Œ ν˜ΈμΆœλ˜λŠ” ν•¨μˆ˜λ₯Ό μ—°κ²°ν•΄μš”.

OnUpEvent

λ²„νŠΌμ΄ λˆŒλ Έλ‹€κ°€ λ–Όμ–΄μ§ˆ λ•Œ ν˜ΈμΆœλ˜λŠ” μ΄λ²€νŠΈμ—μš”. μ—°κ²°ν•¨μˆ˜ ν˜•μ‹μ€ function(upButton), upButton λŠ” λˆŒλ Έλ‹€κ°€ 떼어진 μœ„μ ―λ²„νŠΌ 객체 μž…λ‹ˆλ‹€.

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button

local function UpEvent(self) --OnUpEvent둜 μ—°κ²°λœ ν•¨μˆ˜λŠ” self μΈμžκ°€ κ³ μ •μ μœΌλ‘œ λ“€μ–΄κ°€μš”.
    print(self.Name .. " Button Click!")
end
button.OnUpEvent:Connect(UpEvent) --λ²„νŠΌμ— ν•΄λ‹Ή λ²„νŠΌμ΄ λˆŒλ Έλ‹€κ°€ λ–Όμ–΄μ§ˆ λ•Œ ν˜ΈμΆœλ˜λŠ” ν•¨μˆ˜λ₯Ό μ—°κ²°ν•΄μš”.

속성

ImageDrawType

λ²„νŠΌ μ΄λ―Έμ§€μ˜ DrawType을 μ„€μ •ν•˜κ³  얻을 수 μžˆμ–΄μš” (None, Tile, Slice, Border).

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button

button.ImageDrawType = Enum.ImageDrawType.Image

ImageSliceLeftRight

λ²„νŠΌ μ΄λ―Έμ§€μ˜ DrawType이 Slice, Border일 λ•Œμ˜ Slice μ’Œμš°μ˜μ—­(각각 0λΆ€ν„° 1사이)을 μ •ν•˜κ³  얻을 수 μžˆμ–΄μš”(Left, Right).

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button

button.ImageDrawType = Enum.ImageDrawType.Slice
button.SliceLeftRight = Vector.new(0.5, 0.5, 0) --X : 쒌 / Y : 우

ImageSliceTopBottm

λ²„νŠΌ μ΄λ―Έμ§€μ˜ DrawType이 Slice, Border일 λ•Œμ˜ Slice μ’Œμš°μ˜μ—­(각각 0λΆ€ν„° 1사이)을 μ •ν•˜κ³  얻을 수 μžˆμ–΄μš”(Top, Bottom).

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button

button.ImageDrawType = Enum.ImageDrawType.Slice
button.SliceTopBottom = Vector.new(0.5, 0.5, 0) --X : 상 / Y : ν•˜

ImageTiling

λ²„νŠΌ μ΄λ―Έμ§€μ˜ DrawType이 Tile일 λ•Œμ˜ μ˜΅μ…˜κ°’μ„ μ„€μ •ν•˜κ³  얻을 수 μžˆμ–΄μš” (NoTile, Horizontal, Vertical, Both)

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button

button.ImageDrawType = Enum.ImageDrawType.Image
button.ImageTiling = Enum.ImageTilingType.Both

ν•¨μˆ˜

void SetText(number Value)

(X.0 , X) 값은 λͺ¨λ‘ X둜 λ°˜ν™˜λ˜μ„œ 좜λ ₯λ©λ‹ˆλ‹€. X.0을 좜λ ₯ν•˜κ³  μ‹ΆμœΌλ©΄ tostring으둜 λ³€ν™˜ν›„ μ΄μš©ν•΄μ£Όμ„Έμš” μœ„μ ―μ˜ ν…μŠ€νŠΈλ₯Ό 주어진 μ‹€μˆ˜λ‘œ λ³€κ²½ν•΄μš”. ( λ³€κ²½ν•  μ‹€μˆ˜ κ°’)

void SetText(string InText)

μœ„μ ―μ˜ ν…μŠ€νŠΈλ₯Ό 주어진 λ¬Έμžμ—΄λ‘œ λ³€κ²½ν•΄μš”. (λ³€κ²½ν•  λ¬Έμžμ—΄)

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
button:SetText("Hello World!")

string GetText()

μœ„μ ―μ— μ„€μ •λœ ν…μŠ€νŠΈλ₯Ό 얻을 수 μžˆμ–΄μš”.

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
print(button:GetText())

void SetTextColor(Color color)

ν…μŠ€νŠΈμ˜ 색을 μ„€μ •ν•  수 μžˆμ–΄μš”. (λ³€κ²½ν•  Color κ°’)

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
button:SetTextColor(Color.new(0, 255, 0, 255))

Color GetTextColor()

ν…μŠ€νŠΈμ˜ 색을 κ°€μ Έμ˜¬ 수 μžˆμ–΄μš”.

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
print(button:GetTextColor())

void SetBackgroundColor(Color color)

λ²„νŠΌ μœ„μ ―μ˜ λ°°κ²½ 색을 μ„€μ •ν•  수 μžˆμ–΄μš”. (λ³€κ²½ν•  색)

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
button:SetBackgroundColor(Color.new(0, 255, 0, 255))

Color GetBackgroundColor()

λ²„νŠΌ μœ„μ ―μ˜ λ°°κ²½ 색을 μ–»μ–΄μ˜¬ 수 μžˆμ–΄μš”.

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
print(button:GetBackgroundColor())

void SetButtonHoverColor(Color color)

λ²„νŠΌ μœ„μ ―μ˜ Hover 색을 μ„€μ •ν•  수 μžˆμ–΄μš”. (λ³€κ²½ν•  색)

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
button:SetButtonHoverColor(Color.new(0, 255, 0, 255))

Color GetButtonHoverColor()

λ²„νŠΌ μœ„μ ―μ˜ Hover 색을 κ°€μ Έμ˜¬ 수 μžˆμ–΄μš”.

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
print(button:GetButtonHoverColor())

void SetButtonPressColor(Color color)

λ²„νŠΌ μœ„μ ―μ˜ Press 색을 μ„€μ •ν•  수 μžˆμ–΄μš”. (λ³€κ²½ν•  색)

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
button:SetButtonPressColor(Color.new(0, 255, 0, 255))

Color GetButtonPressColor()

λ²„νŠΌ μœ„μ ―μ˜ Press 색을 κ°€μ Έμ˜¬ 수 μžˆμ–΄μš”.

-- μƒ˜ν”Œ --

local button = Workspace.ScreenUI.Button
print(button:GetButtonPressColor())

μ‚¬μš© κ°€λŠ₯ν•œ λΆ€λͺ¨ 였브젝트 κΈ°λŠ₯λ“€

속성

이름

μ„€λͺ…

Location

μœ„μ ―μ˜ μœ„μΉ˜λ₯Ό λ³€κ²½ν•  수 μžˆμ–΄μš”. (Xμ’Œν‘œ κ°’, Yμ’Œν‘œ κ°’, 0)

Rotation

μœ„μ ―μ˜ νšŒμ „μ„ μ„€μ •ν•  수 μžˆμ–΄μš”. (μ„€μ •ν•  κ°’)

Scale

μœ„μ ―μ˜ μŠ€μΌ€μΌμ„ μ„€μ •ν•  수 μžˆμ–΄μš”. (μ„€μ •ν•  κ°’)

Size

μœ„μ ―μ˜ 크기λ₯Ό μ„€μ •ν•  수 μžˆμ–΄μš”. (κ°€λ‘œκ°’, μ„Έλ‘œκ°’, 0)

ZOrder

μœ„μ ―μ˜ κ·Έλ¦¬λŠ” μˆœμ„œλ₯Ό μ„€μ •ν•  수 μžˆμ–΄μš”.

Visible

UI μœ„μ ―μ˜ ν‘œμ‹œ μ—¬λΆ€λ₯Ό μ„€μ •ν•  수 μžˆμ–΄μš”. (μœ„μ ― ν‘œμ‹œ μ—¬λΆ€)

Interaction

UI μœ„μ ―μ˜ λ°˜μ‘ μ—¬λΆ€λ₯Ό μ„€μ •ν•  수 μžˆμ–΄μš”. (μœ„μ ― λ°˜μ‘ μ—¬λΆ€)

Opacity

μœ„μ ―μ˜ 투λͺ… 값을 μ„€μ •ν•  수 μžˆμ–΄μš”. (μ„€μ •ν•  κ°’)

AnchorType

μœ„μ ―μ˜ κ³ μ • μ—¬λΆ€λ₯Ό μ„€μ •ν•  수 μžˆμ–΄μš”. (μ„€μ •ν•  νƒ€μž…)

IsFill

μœ„μ ―μ˜ μ±„μš°κΈ°λ₯Ό μ„€μ •ν•  수 μžˆμ–΄μš”.

이벀트

이름

μ„€λͺ…

OnVisibleEvent

widget이 λ³΄μ—¬μ§ˆ λ•Œ ν˜ΈμΆœλ˜λŠ” μ΄λ²€νŠΈμ—μš”. μ—°κ²°ν•¨μˆ˜ ν˜•μ‹μ€ function(widget), widget 은 λ³΄μ—¬μ§€λŠ” widget 객체 μž…λ‹ˆλ‹€.

OnInVisibleEvent

widget이 μ•ˆ λ³΄μ—¬μ§ˆ λ•Œ ν˜ΈμΆœλ˜λŠ” μ΄λ²€νŠΈμ—μš”. μ—°κ²°ν•¨μˆ˜ ν˜•μ‹μ€ function(widget), widget 은 μ•ˆ λ³΄μ—¬μ§€λŠ” widget 객체 μž…λ‹ˆλ‹€.

OnBeginDragEvent

widget의 λ“œλž˜κ·Έκ°€ μ‹œμž‘ 될 λ•Œ ν˜ΈμΆœλ˜λŠ” μ΄λ²€νŠΈμ—μš”. μ—°κ²°ν•¨μˆ˜ ν˜•μ‹μ€ function(widget, vector2D), widget은 ν΄λ¦­ν•œ 객체, vector2DλŠ” 마우슀 μœ„μΉ˜μ—μš”.

OnCancelDragEvent

widget의 λ“œλž˜κ·Έκ°€ μ·¨μ†Œλ  λ•Œ ν˜ΈμΆœλ˜λŠ” μ΄λ²€νŠΈμ—μš”. μ—°κ²°ν•¨μˆ˜ ν˜•μ‹μ€ function(widget, vector2D), widget은 ν΄λ¦­ν•œ 객체, vector2DλŠ” 마우슀 μœ„μΉ˜μ—μš”.

OnEndDragEvent

widget의 λ“œλž˜κ·Έκ°€ λ“œλžλ  λ•Œ ν˜ΈμΆœλ˜λŠ” μ΄λ²€νŠΈμ—μš”. μ—°κ²°ν•¨μˆ˜ ν˜•μ‹μ€ function(widget, vector2D, dragwidget), widget은 λ“œλžν•œ 객체, vector2DλŠ” 마우슀 μœ„μΉ˜, dragwidgetλŠ” λ“œλž˜κ·Έν•œ widgetμ—μš”.

ν•¨μˆ˜

이름

μ„€λͺ…

AddChildUIScene

(deprecate) AddChildUIWidget ν•¨μˆ˜λ‘œ μ΄μš©ν•˜μ„Έμš”.

AddChildWidget

μžμ‹ UI μœ„μ ―μ„ μΆ”κ°€ν•  수 μžˆμ–΄μš”. (μžμ‹μœΌλ‘œ μΆ”κ°€ν•  UI μœ„μ ―)

SetParentWidget

λΆ€λͺ¨ UI μœ„μ ―μ„ μ„€μ •ν•  수 μžˆμ–΄μš”. (λΆ€λͺ¨λ‘œ μ„€μ •ν•  UI μœ„μ ―)

Delete

μœ„μ ―μ„ μ œκ±°ν•  수 μžˆμ–΄μš”.

GetTypeString

μœ„μ ―μ˜ νƒ€μž…μ„ λ¬Έμžμ—΄λ‘œ 얻을 수 μžˆμ–΄μš”.

GetType

μœ„μ ―μ˜ νƒ€μž…μ„ Enum ν˜•μ‹μœΌλ‘œ 얻을 수 μžˆμ–΄μš”.

SetDragWidget

μœ„μ ―μ˜ DragEvent λ°œμƒ μ‹œ λ³΅μ‚¬λ˜μ–΄ λ³΄μ—¬μ§ˆ widget을 μ„ΈνŒ…ν•΄μš”.

SetDragOffset

μœ„μ ―μ˜ DragWidget에 적용될 Offset μ΄μ—μš”.

PreviousBlendAnimStateSettingNextCamera

Last updated