<QtDeprecationMarkers> - Qt Deprecation Macros

<QtDeprecationMarkers> 헤더 파일에는 사용 중단 관련 보조 매크로가 포함되어 있습니다. 더 보기...

Header: #include <QtDeprecationMarkers>

매크로

상세 설명

이 헤더 파일은 더 이상 사용되지 않는 Qt API를 비활성화하고, 해당 API가 사용될 때 컴파일러 경고를 활성화하거나 비활성화하기 위한 여러 매크로를 선언합니다.

매크로 문서

QT_DEPRECATED_WARNINGS

Qt 5.13부터는 이 매크로가 아무런 효과를 발휘하지 않습니다. Qt 5.12 및 그 이전 버전에서는 이 매크로가 정의되어 있으면, Qt에서 더 이상 사용하지 말 것을 권장하는 것으로 선언된 API가 사용될 경우 컴파일러가 경고를 발생시킵니다.

QT_DISABLE_DEPRECATED_UP_TO, QT_NO_DEPRECATED_WARNINGS 및 QT_WARN_DEPRECATED_UP_TO도 참조하십시오 .

QT_DISABLE_DEPRECATED_UP_TO

이 매크로는 프로젝트 파일에서 정의하여, 지정된 Qt 버전 또는 그 이전 버전에서 사용 중단된 함수를 비활성화할 수 있습니다. 기본 버전 번호는 5.0이며, 이는 Qt 5.0 또는 그 이전 버전에서 사용 중단된 함수가 포함되지 않음을 의미합니다.

예를 들어, Qt 6.3으로 업그레이드할 준비를 할 때, 모든 사용 중단 경고를 제거한 후 ` QT_DISABLE_DEPRECATED_UP_TO=0x060300 `를 설정하여 더 이상 사용하지 않는 Qt API를 빌드에서 제외할 수 있습니다. 프로젝트의 빌드 구성에서 이 설정을 적용하면, 사용 중단된 API에 대한 새로운 호출을 추가하는 사람이 즉시 이를 인지할 수 있게 됩니다. 또한 개인적으로 Qt를 빌드하는 경우, Qt의 빌드 구성에 이 정의(define)를 포함하면 비추천된 API의 구현체까지 제외함으로써 바이너리 크기를 줄일 수 있습니다.

참고: 링커 오류를방지하려면 전체 바이너리에서 동일한 비추천 수준을 일관되게 사용해야 합니다. 즉, 정적 빌드의 경우 Qt 라이브러리도 사용자 코드와 동일한 버전의 QT_DISABLE_DEPRECATED_UP_TO 가 설정된 상태로 빌드되어야 합니다. 정적 빌드에서는 Qt 라이브러리도 바이너리의 일부가 되기 때문입니다.

QT_DEPRECATED_WARNINGS 및 QT_WARN_DEPRECATED_UP_TO도 참조하십시오 .

QT_NO_DEPRECATED_WARNINGS

이 매크로는 더 이상 사용되지 않는 API를 사용할 때 발생하기 마련인 사용 중단 경고 메시지를 억제하는 데 사용할 수 있습니다.

QT_DISABLE_DEPRECATED_UP_TO 및 QT_WARN_DEPRECATED_UP_TO도 참조하십시오 .

QT_WARN_DEPRECATED_UP_TO

이 매크로를 프로젝트 파일에 정의하면, 지정된 버전보다 높은 Qt 버전에서 도입된 사용 중단 경고가 비활성화됩니다.

예를 들어, Qt 6.10으로 업그레이드할 준비를 하는 중인데 모든 비추천 경고에 대응할 준비가 되어 있지 않다면, ` QT_WARN_DEPRECATED_UP_TO=0x060900 `을 설정하여 비추천 경고를 6.9 및 그 이전 버전의 경고로만 제한할 수 있습니다.

QT_DISABLE_DEPRECATED_UP_TO 및 QT_NO_DEPRECATED_WARNINGS도 참조하십시오 .

© 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.