기본 컴포넌트 속성 설정하기

Properties 보기에는 선택한 컴포넌트의 모든 속성이 표시됩니다. 속성은 유형별로 그룹화됩니다. 뷰의 상단에는 컴포넌트 유형, ID, 이름, 지오메트리 및 표시 여부와 같이 모든 컴포넌트에 공통으로 적용되는 속성이 표시됩니다.

뷰의 아래쪽에는 컴포넌트 유형에 대해 정의된 속성이 표시됩니다. 예를 들어 다음 이미지에는 Rectangle 및 Text 컴포넌트에 대해 설정할 수 있는 미리 정의된 속성이 표시됩니다.

기본 속성 설정

모든 컴포넌트는 Properties 보기에서 지정할 수 있는 일련의 속성을 공유합니다.

컴포넌트 유형 변경

사전 설정 컴포넌트의 인스턴스를 만들면 사용한 사전 설정의 모든 속성을 갖게 됩니다. 나중에 다른 기본 속성 세트를 가진 다른 프리셋 컴포넌트가 목적에 더 적합하다고 생각되면 Type 필드를 두 번 클릭하고 해당 필드에 다른 프리셋 컴포넌트의 이름을 입력하여 컴포넌트 유형을 변경할 수 있습니다.

새 컴포넌트 유형에서 지원되지 않는 속성 값을 지정한 경우 Qt Quick 디자이너에서 해당 값을 제거해 줍니다. 이 작업을 직접 수행하려면 속성 이름 옆의 (Actions) 메뉴를 선택한 다음 Reset 을 선택하여 속성 값을 제거한 후 다시 시도할 수 있습니다.

컴포넌트 ID 설정

각 컴포넌트와 컴포넌트의 각 인스턴스에는 고유하게 식별하고 다른 컴포넌트의 프로퍼티를 바인딩할 수 있는 ID가 있습니다. ID 필드에 컴포넌트의 ID를 지정할 수 있습니다.

ID는 고유해야 하며 소문자 또는 밑줄 문자로 시작해야 하고 문자, 숫자, 밑줄 문자만 포함할 수 있습니다.

ID에 대한 자세한 기술 정보는 ID 속성을 참조하세요.

컴포넌트 외부에서 사용할 수 있는 속성 별칭을 추가하려면 을 선택합니다. Actions 메뉴의 메뉴 항목을 사용하여 하위 컴포넌트의 속성 값에 대한 속성 별칭을 추가할 수 있습니다.

어노테이션에 대한 컴포넌트 이름 설정

Name 필드의 값은 어노테이션에 사용되는 컴포넌트 이름을 지정합니다. 컴포넌트를 설명하는 자유 형식의 텍스트입니다.

2D 지오메트리 설정

Geometry - 2D 섹션에서 속성을 설정하여 컴포넌트의 위치와 크기를 결정합니다.

Position 그룹에서는 x축과 y축에서 컴포넌트의 위치를 설정할 수 있습니다. UI에서 컴포넌트의 위치는 절대적이거나 다른 컴포넌트에 대한 상대적일 수 있습니다. 자세한 내용은 레이아웃을 확장 가능하게 만들기를 참조하세요.

2D 공간에서 컴포넌트의 z 위치는 컴포넌트 계층 구조에서 형제 컴포넌트와의 관계를 기준으로 위치를 결정합니다. z 위치는 Z stack 필드에서 설정할 수 있습니다.

Size 그룹에서 컴포넌트의 너비와 높이를 설정할 수 있습니다. 크기 조정 커서를 사용하여 2D 보기에서 2D 컴포넌트의 크기를 조정할 수도 있습니다. X 및 Y 필드의 값은 그에 따라 변경됩니다.

레이아웃을 사용할 때 컴포넌트 크기와 위치도 자동으로 관리할 수 있습니다.

컴포넌트 파일에서 루트 컴포넌트의 너비와 높이에 따라 컴포넌트의 크기가 결정됩니다. 컴포넌트의 최종 크기가 속성 바인딩에 의해 결정되는 경우 컴포넌트 크기는 0(0,0)이 될 수도 있습니다. 자세한 내용은 컴포넌트 크기 미리 보기를 참조하세요.

컴포넌트 위치 및 크기 재설정

컴포넌트를 이동한 후 기본 위치로 되돌리려면 2D 또는 Navigator 보기에서 마우스 오른쪽 버튼을 클릭하고 Edit > Reset Position 을 선택합니다. 기본 크기로 되돌리려면 2D 또는 Navigator 보기에서 마우스 오른쪽 버튼을 클릭하고 Edit > Reset Size 을 선택합니다.

2D 변환 관리

회전 및 크기 조정과 같은 변환을 컴포넌트에 원하는 수만큼 지정할 수 있습니다. 각 변형은 한 번에 하나씩 순서대로 적용됩니다.

Origin 필드에서 크기 조정 및 회전을 위한 원점을 선택합니다.

Scale 필드에서 배율을 설정합니다. 1.0보다 작은 값은 컴포넌트를 작게 만들고, 1.0보다 큰 값은 컴포넌트를 크게 만듭니다. 음수 값은 2D 보기에서 컴포넌트가 미러링되도록 합니다.

Rotation 필드에서 원점을 중심으로 컴포넌트의 회전을 시계 방향으로 지정합니다.

또는 2D 보기에서 컴포넌트를 드래그하여 이동, 크기 조정 또는 회전할 수 있습니다.

컴포넌트 가시성 설정

Visibility 섹션에서 속성을 설정하여 컴포넌트를 표시하거나 숨길 수 있습니다.

명시적으로 표시하도록 설정하지 않은 컴포넌트와 그 하위 컴포넌트를 모두 숨기려면 Visible 의 선택을 취소합니다. 속성 바인딩을 사용할 때 예상치 못한 효과가 발생할 수 있습니다. 이러한 경우 Opacity 속성을 대신 사용하는 것이 더 나을 수 있습니다.

이 속성을 비활성화하면 컴포넌트는 더 이상 마우스 이벤트를 수신하지 않습니다. 그러나 키 이벤트는 계속 수신되며 Advanced 섹션에서 Enabled 을 선택하면 키보드 포커스 이벤트는 유지됩니다.

가시성 값은 이 속성 또는 부모의 가시성 속성의 변경에 의해서만 영향을 받습니다. 예를 들어 이 컴포넌트가 화면 밖으로 이동하거나 불투명도가 0으로 변경되는 경우에는 변경되지 않습니다.

Opacity 필드에 컴포넌트의 불투명도를 0.0(완전 투명)에서 1.0(완전 불투명) 사이의 숫자로 지정합니다. 지정된 불투명도는 하위 컴포넌트에도 개별적으로 적용되며, 때로는 놀라운 효과가 나타나기도 합니다.

컴포넌트의 불투명도를 변경해도 컴포넌트의 사용자 입력 이벤트 수신 여부에는 영향을 미치지 않습니다.

불투명도 값에 애니메이션을 적용하여 컴포넌트가 페이드 인 및 페이드 아웃되도록 할 수 있습니다.

Clip 을 선택하면 컴포넌트와 그 자식이 컴포넌트의 경계 사각형으로 잘립니다.

State 필드에서 상태를 선택하면 해당 상태의 속성 값을 변경할 수 있습니다.