이 페이지에서

url QML Value Type

리소스 로케이터. 더 보기...

상세 설명

url 유형은 리소스 로케이터(예: 파일 이름)를 나타냅니다. 절대 경로(예: "http://qt-project.org")이거나 상대 경로(예: "pics/logo.png")일 수 있습니다. 상대 URL은 해당 컴포넌트의 URL을 기준으로 해석됩니다.

예를 들어, 다음 코드는 url 유형인 Image::source 속성에 유효한 URL을 할당합니다:

Image { source: "pics/logo.png" }

C++과 통합할 때, C++에서 QML로 전달되는 모든 ` QUrl ` 값은 자동으로 ` url ` 값으로 변환되며, 그 반대의 경우도 마찬가지임을 유의하십시오.

또는 url 을 URL 객체로 변환하여 해당 구성 요소에 접근하고 수정할 수도 있습니다:

var urlObject = new URL(url);

참고: Qt5에서는 URL을 url 속성에 할당할 때 현재 컨텍스트를 기반으로 URL이 자동으로 해결되었습니다. 이로 인해 상대 URL을 사용할 수 없었으며, 이전에 속성에 기록된 URL을 다시 읽을 때 일관성 없는 동작이 발생했습니다. 따라서 Qt 6에서는 동작이 변경되어, 할당 시 URL이 더 이상 자동으로 해결되지 않습니다. URL을 사용하는 개별 요소는 URL을 직접 해결해야 합니다.

참고: QML 내에서 Qt 리소스 시스템에 저장된 파일을 참조할때는 QML이 URL 경로를 요구하므로 ":/" 대신 "qrc:///"를 사용해야 합니다. 해당 파일 내에서 해결된 상대 URL은 동일한 프로토콜을 사용합니다.

또한, URL에는 RFC 3986에 명시된 ‘퍼센트 인코딩(percent-encoding)’ 방식을 사용한 인코딩된 문자가 포함될 수 있습니다. 이러한 문자는 url 유형의 속성 내에서 보존되어, QML 코드가 정확한 URL 값을 구성할 수 있도록 합니다.

예를 들어, 일반적으로 URL 'fragment' 요소의 시작 부분으로 해석되는 '#' 문자가 포함된 로컬 파일은 파일 이름의 문자를 인코딩하여 액세스할 수 있습니다.

Image { source: encodeURIComponent("/tmp/test#1.png") }

이 값 유형은 QML 언어에서 제공합니다.

QML 값 유형도 참조하십시오 .

© 2026 The Qt Company Ltd. 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.