이 페이지에서

사용자 지정 속성 추가하기

사전 설정 컴포넌트에는 값을 지정할 수 있는 사전 설정 속성 세트가 있습니다. 특정 컴포넌트 유형에 대해 존재하지 않는 사용자 지정 속성을 추가할 수 있습니다. 프로퍼티를 동적 표현식에 바인딩하여 다른 컴포넌트에서 읽을 수 있는 컴포넌트의 전역 프로퍼티를 정의할 수 있습니다. 예를 들어 루트 컴포넌트에 대해 하위 컴포넌트에서 사용할 수 있는 전역 속성을 지정할 수 있습니다.

예를 들어, UI 요소 사이의 간격을 지정하려면 여백 속성이 없는 컴포넌트에 여백을 정의한 다음 바인딩을 사용하여 다른 컴포넌트의 여백 속성 값을 참조할 수 있습니다.

마찬가지로 사전 설정 컴포넌트를 기반으로 하는 자체 컴포넌트에 대한 사용자 지정 속성을 추가할 수 있습니다.

데이터 기반 콘텐츠는 관련 컴포넌트의 공개 속성(별칭 속성)으로 내보내야 합니다. 예를 들어 속도계에는 UI가 바인딩되는 속도에 대한 int 또는 실수 프로퍼티가 있어야 합니다.

설정 보기의 로컬 사용자 지정 속성 및 노출된 사용자 지정 속성 설정입니다.

컴포넌트에 프로퍼티 추가하기

컴포넌트에 대한 사용자 지정 프로퍼티를 추가하려면 다음과 같이 하세요:

  1. Properties > Local Custom Properties 으로 이동합니다.
  2. 더하기 버튼 (Add)를 선택합니다.

    속성 보기에서 속성 추가하기.

  3. 속성에 NameType 을 설정합니다.

    새 속성 추가 대화상자입니다.

    새 속성 추가 대화 상자가 나타납니다.

  4. Add Property 을 선택하여 속성을 추가합니다.

속성 값 바인딩

속성 값을 다른 속성 값이나 애플리케이션에서 액세스할 수 있는 데이터에 바인딩합니다:

  1. Properties 보기에서 속성 옆의 작업 버튼 을 선택합니다.
  2. Set Binding 을 선택합니다.

    바인딩 편집기.

    바인딩 편집기 대화 상자가 열립니다.

자세한 내용은 바인딩 설정을 참조하세요.

연결 보기에서 사용자 지정 속성 추가

Connections 보기에서 컴포넌트에 대한 사용자 지정 속성을 추가하려면 다음과 같이 하세요:

  1. 2D 또는 Navigator 보기에서 컴포넌트를 선택합니다.
  2. Connections > Properties 으로 이동합니다.

    연결 보기의 속성 탭입니다.

  3. 더하기 버튼 (Add)를 선택하여 사용자 지정 속성을 추가합니다.
  4. 사용자 지정 속성 편집기에서 포함할 속성의 Type 을 선택합니다.

    사용자 지정 속성 편집기.

    사용자 지정 속성 편집기.

  5. 속성의 NameValue 을 설정합니다.

사용자 정의 속성 제거하기

Connections > Properties 로 이동하여 마이너스 버튼 (Remove)를 선택하여 선택한 사용자 정의 속성을 삭제합니다.

지원되는 속성 유형

다음 표에서는 지원되는 속성 유형에 대해 설명합니다:

유형설명
별칭다른 프로퍼티에 대한 참조를 담고 있는프로퍼티 별칭입니다.
bool바이너리 true 또는 false
color"red", "green", "lightsteelblue" 와 같은 SVG 색상 이름 또는 각각 "#RRGGBB", "#AARRGGBB" 형식의 16진수 삼중항 또는 사중항을 사용하여 지정할 수 있는 색상 값입니다. 예를 들어 빨간색은 "#FF0000" 의 삼중색에, 약간 투명한 파란색은 "#800000FF" 의 사중색에 해당합니다. 또한 Qt.rgba(), Qt.hsva(), Qt.hsla(), Qt.darker(), Qt.lighter(), Qt.tint()와 같은 Qt 함수를 사용할 수 있습니다.
int0, 10 또는 -20과 같은 정수 전체 숫자
real소수점이 있는 숫자
문자열자유 형식 텍스트 문자열
텍스처 입력커스텀 머티리얼 또는 이펙트의 셰이더에 노출되는 텍스처를 지정합니다.
url파일 이름과 같은 리소스 로케이터입니다. 절대(http://qt-project.org) 또는 상대(pics/logo.png)일 수 있습니다. 상대 URL은 부모 컴포넌트의 URL을 기준으로 확인됩니다.
variant일반 속성 유형입니다. 예를 들어 변형 프로퍼티에는 숫자, 문자열, 객체, 배열 및 함수를 저장할 수 있습니다.
vector2dx 및 y 속성을 가진 값을 나타냅니다.
vector3dx, y, z 속성을 가진 값을 나타냅니다.
vector4dx, y, z, w 속성을 가진 값을 나타냅니다.

방법도참조하세요 :UI 컴포넌트 사용, Qt Quick UI 디자인 Qt Quick UI 디자인하기 참조하세요.

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.