Maya cmds.textFieldGrp 상세 매뉴얼

작성자:

Maya cmds.textFieldGrp 상세 매뉴얼
 

개요

 

Autodesk Maya의 cmds.textFieldGrp 명령어는 라벨과 하나 이상의 텍스트 필드로 구성된 UI 요소 그룹을 생성하는 데 사용됩니다.
이 명령어는 사용자로부터 이름, 경로 또는 기타 문자열 데이터를 입력받는 사용자 인터페이스를 만들 때 특히 유용합니다.

 

문법

 

cmds.textFieldGrp([name], [text], [adjustableColumn], [columnAlign], [columnWidth], [cw], [cat], [ann], [cc], [dgc], [w], [cal], [cw], [co2], [ct2], [cw2], [ed], [en], [fn], [hlc], [hvl], [hvw], [ut], [vis], [w], [p], [fp])

 

플래그

 

annotation (`ann`): 툴팁으로 나타나는 주석 문자열을 지정합니다.

cmds.textFieldGrp(annotation="This is a text field", ...)

 

backgroundColor (`bgc`): 텍스트 필드의 배경색을 지정합니다.

cmds.textFieldGrp(backgroundColor=(0.5, 0.5, 0.5), ...)

 

columnAlign (`cal`): 열 내의 텍스트 정렬을 지정합니다.

cmds.textFieldGrp(columnAlign=(1, 'left'), ...)

 

columnAttach (`cat`): 열의 부착 위치를 지정합니다.

cmds.textFieldGrp(columnAttach=(1, 'both', 5), ...)

 

columnWidth (`cw`): 열의 너비를 지정합니다.

cmds.textFieldGrp(columnWidth=[(1, 50), (2, 200)], ...)

 

editable (`ed`): 텍스트 필드의 편집 가능 여부를 지정합니다.

cmds.textFieldGrp(editable=False, ...)

 

enable (`en`): 텍스트 필드의 활성화 여부를 지정합니다.

cmds.textFieldGrp(enable=False, ...)

 

enableBackground (`ebg`): 텍스트 필드의 배경색 활성화 여부를 지정합니다.

cmds.textFieldGrp(enableBackground=True, ...)

 

font (`fn`): 텍스트 필드에 사용되는 글꼴을 지정합니다.

cmds.textFieldGrp(font="boldLabelFont", ...)

 

height (`h`): 텍스트 필드의 높이를 지정합니다.

cmds.textFieldGrp(height=30, ...)

 

highlightColor (`hlc`): 텍스트 필드의 강조 색상을 지정합니다.

cmds.textFieldGrp(highlightColor=(1.0, 0.5, 0.5), ...)

 

label (`label`): 라벨 텍스트를 지정합니다.

cmds.textFieldGrp(label="Enter Name", ...)

 

manage (`mng`): 텍스트 필드 그룹의 관리를 지정합니다.

cmds.textFieldGrp(manage=False, ...)

 







 

noBackground (`nbg`): 텍스트 필드의 배경 유무를 지정합니다.

cmds.textFieldGrp(noBackground=True, ...)

 

numberOfFields (`nf`): 그룹 내 텍스트 필드의 개수를 지정합니다.

cmds.textFieldGrp(numberOfFields=2, ...)

 

parent (`p`): 텍스트 필드 그룹의 부모 레이아웃을 지정합니다.

cmds.textFieldGrp(parent="layoutName", ...)

 

placeholderText (`ph`): 텍스트 필드의 플레이스홀더 텍스트를 지정합니다.

cmds.textFieldGrp(placeholderText="Enter text here...", ...)

 

preventOverride (`po`): 텍스트 필드의 오버라이드 방지를 지정합니다.

cmds.textFieldGrp(preventOverride=True, ...)

 

text (`tx`): 텍스트 필드의 기본 텍스트를 지정합니다.

cmds.textFieldGrp(text="Default text", ...)

 

width (`w`): 텍스트 필드 그룹의 너비를 지정합니다.

cmds.textFieldGrp(width=400, ...)

 

실용적인 예제

 

기본 사용법

 

이 예제는 이름을 입력할 수 있는 textFieldGrp를 사용하여 간단한 UI를 생성합니다:

import maya.cmds as cmds

def simple_ui():
    if cmds.window("simpleUI", exists=True):
        cmds.deleteUI("simpleUI")
    
    cmds.window("simpleUI", title="Simple UI", widthHeight=(300, 100))
    cmds.columnLayout(adjustableColumn=True)
    
    cmds.textFieldGrp(label='Name:', text='', placeholderText='Enter your name')
    
    cmds.showWindow("simpleUI")

simple_ui()

 

고급 사용법

 

이 예제는 여러 열과 사용자 정의 옵션이 있는 textFieldGrp를 생성하는 고급 사용법을 보여줍니다:

import maya.cmds as cmds

def advanced_ui():
    if cmds.window("advancedUI", exists=True):
        cmds.deleteUI("advancedUI")
    
    cmds.window("advancedUI", title="Advanced UI", widthHeight=(400, 200))
    cmds.columnLayout(adjustableColumn=True)
    
    cmds.textFieldGrp('nameField',
                      label='Name:',
                      text='John Doe',
                      placeholderText='Enter your name',
                      columnAlign=(1, 'right'),
                      columnWidth=[(1, 100), (2, 250)],
                      adjustableColumn=2,
                      annotation='This is where you enter your name')
    
    cmds.showWindow("advancedUI")

advanced_ui()

 

이 상세 매뉴얼은 Maya의 cmds.textFieldGrp 명령어에 대한 광범위한 개요를 제공하며, 문법, 플래그 및 실용적인 예제들을 포함하여 기본 및 고급 사용 사례를 모두 다룹니다.