사용자 정의 속성 추가
각 사전 설정 컴포넌트에는 값을 지정할 수 있는 일련의 사전 설정 속성이 있습니다. 특정 컴포넌트 유형에 원래 존재하지 않는 사용자 정의 속성을 추가할 수 있습니다. 속성을 동적 표현식에 바인딩하여 다른 컴포넌트에서 읽을 수 있는 컴포넌트의 전역 속성을 정의할 수 있습니다. 예를 들어, 자식 컴포넌트에서 사용할 수 있는 루트 컴포넌트의 전역 속성을 지정할 수 있습니다.
예를 들어, UI 요소 간의 간격을 지정하려면 마진 속성이 없는 컴포넌트에 마진을 정의한 다음, 바인딩을 사용하여 다른 컴포넌트에서 해당 마진 속성의 값을 참조할 수 있습니다.
마찬가지로, 사전 정의된 컴포넌트를 기반으로 한 자체 컴포넌트에 사용자 정의 속성을 추가할 수도 있습니다.
데이터 기반인 모든 콘텐츠는 관련 컴포넌트의 공개 속성(alias 속성)으로 내보내야 합니다. 예를 들어, 속도계에는 UI가 바인딩되는 속도를 나타내는 int 또는 real 속성이 있어야 합니다.

컴포넌트에 속성 추가하기
컴포넌트에 사용자 정의 속성을 추가하려면:
- Properties > Local Custom Properties 로 이동합니다.
(Add)를 선택합니다.
- 속성에 대한 ‘ Name ’ 및 ‘ Type ’을 설정합니다.

'새 속성 추가' 대화 상자.
- Add Property 를 선택하여 속성을 추가합니다.
속성 값 바인딩
속성의 값을 다른 속성의 값이나 애플리케이션에서 액세스할 수 있는 데이터에 바인딩하려면:
- ' Properties ' 보기에서 해당 속성 옆에 있는 '
'을 선택합니다. - Set Binding 를 선택합니다.

'바인딩 편집기(Binding Editor)' 대화 상자가 표시됩니다.
자세한 내용은 ‘바인딩 설정’을 참조하십시오.
'Connections' 뷰에서 사용자 정의 속성 추가
' Connections ' 뷰에서 컴포넌트에 대한 사용자 정의 속성을 추가하려면:
- ' 2D ' 또는 ' Navigator ' 뷰에서 컴포넌트를 선택합니다.
- ' Connections ' > ' Properties'로 이동합니다.

- 사용자 정의 속성을 추가하려면 ‘
(Add)’를 선택합니다. - 사용자 정의 속성 편집기에서 포함할 속성의 Type 를 선택합니다.

사용자 정의 속성 편집기.
- 속성의 Name 및 Value 을 설정합니다.
사용자 정의 속성 제거
' Connections ' > ' Properties'로 이동한 다음, '
' (Remove)를 선택하여 선택한 사용자 정의 속성을 삭제합니다.
지원되는 속성 유형
다음 표는 지원되는 속성 유형을 설명합니다:
| 유형 | 설명 |
|---|---|
| 별칭 | 다른 속성에 대한 참조를 포함하는속성 별칭 |
| bool | true 또는 false 값을 나타내는 이진 값 |
| color | "red", "green", "lightsteelblue" 와 같은 SVG 색상 이름이나, 각각 "#RRGGBB" 및 "#AARRGGBB" 형식의 16진수 3자리 또는 4자리 값을 사용하여 지정할 수 있는 색상 값입니다. 예를 들어, 빨간색은 "#FF0000" 의 3원색 조합에 해당하고, 약간 투명한 파란색은 "#800000FF" 의 4원색 조합에 해당합니다. 또한, 다음 Qt 함수를 사용할 수 있습니다: Qt.rgba(), Qt.hsva(), Qt.hsla(), Qt.darker(), Qt.lighter(), Qt.tint(). |
| int | 0, 10, -20과 같은 정수 |
| 실수 | 소수점이 있는 숫자 |
| 문자열 | 자유 형식의 텍스트 문자열 |
| TextureInput | CustomMaterial 또는 Effect의 셰이더에 노출되는 텍스처를 지정합니다. |
| url | 파일 이름과 같은 리소스 로케이터입니다. 절대 경로(https://qt-project.org) 또는 상대 경로(pics/logo.png)일 수 있습니다. 상대 URL은 상위 컴포넌트의 URL을 기준으로 해결됩니다. |
| 변형 | 일반 속성 유형입니다. 예를 들어, variant 속성은 숫자, 문자열, 객체, 배열 및 함수를 저장할 수 있습니다. |
| vector2d | x 및 y 속성을 가진 값을 가리킵니다. |
| vector3d | x, y, z 속성을 가진 값을 말합니다. |
| vector4d | x, y, z 및 w 속성을 가진 값을 나타냅니다. |
Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.