클래스 지정자

클래스가 엔진과 에디터의 다양한 부분과 어떻게 작동하는지를 지정하기 위해 UClass 선언시 사용되는 키워드입니다.

Choose your operating system:

Windows

macOS

Linux

메타데이터 지정자

클래스를 선언할 때, 선언부에 Class Specifier (클래스 지정자)를 붙이면 클래스가 엔진과 에디터의 다양한 부분과 어떻게 작동하는지를 제어할 수 있습니다.


클래스 지정자	효과
`Abstract`	Abstract (추상) 지정자는 클래스를 "추상 베이스 클래스" 로 선언하여, 사용자가 이 클래스 액터를 월드에 추가하지 못하도록 합니다. 그 자체로는 의미가 없는 클래스에 쓰기 좋습니다. 예를 들어 `ATriggerBase` 베이스 클래스는 추상형이라도 그 서브클래스 `ATriggerBox` 가 추상형이 아니라면 레벨에 배치할 수 있습니다.
`AdvancedClassDisplay`	이 클래스의 모든 프로퍼티가 디테일 패널의 고급 섹션 에만 표시되도록 합니다. 개별 프로퍼티에서 이 옵션을 덮어쓰려면, 해당 프로퍼티에 `SimpleDisplay` 지정자를 사용하면 됩니다.
`AutoCollapseCategories=(Category1, Category2, ...)`	이 지정자는 나열된 카테고리에 대해, 부모 클래스 상의 AutoExpandCategories 지정자 효과를 무효화시킵니다.
`AutoExpandCategories=(Category1, Category2, ...)`	이 클래스의 오브젝트에 대해서는 언리얼 에디터 프로퍼티 창에 자동 확장되도록 할 카테고리를 하나 이상 지정합니다. 카테고리 없이 선언된 변수를 자동 확장하려면, 변수를 선언한 클래스 이름을 사용하면 됩니다.
`Blueprintable`	이 클래스를 블루프린트 생성이 가능한 베이스 클래스로 노출시킵니다. 기본값은 다른 식으로 상속되지 않는 한 `NotBlueprintable` 입니다. 이 지정자는 서브클래스에 상속됩니다.
`BlueprintType`	이 클래스를 블루프린트에서 변수로 사용할 수 있는 유형으로 노출시킵니다.
`ClassGroup=GroupName`	언리얼 에디터의 액터 브라우저 에서 그룹 뷰 옵션을 켰을 때 지정된 `GroupName` 내에서 이 클래스와 그 서브클래스를 포함시킬지 여부를 나타냅니다.
`CollapseCategories`	이 클래스의 프로퍼티는 언리얼 에디터 프로퍼티 창의 카테고리에 그룹으로 묶이지 않아야 함을 나타냅니다. 이 지정자는 자식 클래스에 전파되지만, 자식 클래스에서 `DontCollapseCategories` 지정자를 사용하여 덮어쓸 수 있습니다.
`Config=ConfigName`	이 클래스는 환경설정 ( `.ini` ) 파일에 데이터를 저장할 수 있음을 나타냅니다. `config` 또는 `globalconfig` 지정자로 선언된 클래스 프로퍼티가 있는 경우, 이 지정자는 그 프로퍼티를 해당 이름의 환경설정 파일에 저장하도록 합니다. 이 지정자는 모든 자식 클래스에 전파되며 무효화시킬 수 없으나, 자식 클래스에서는 환경설정 파일을 바꿀 수는 있습니다. `config` 지정자에 다른 `ConfigName` 으로 다시 선언해주면 됩니다. 일반적인 `ConfigName` 값은 "Engine", "Editor", "Input", "Game" 입니다.
`Const`	이 클래스의 모든 프로퍼티와 함수는 `const` 이며 `const` 로 노출됩니다. 이 지정자는 서브클래스에 상속됩니다.
`ConversionRoot`	루트 변환 시 서브클래스가 계층구조상의 첫 번째 루트 클래스의 자손 클래스로만 변환할 수 있도록 제한합니다.
`CustomConstructor`	생성자 선언의 자동 생성을 방지합니다.
`DefaultToInstanced`	이 클래스의 모든 인스턴스는 "instanced" 로 간주합니다. 인스턴스드 클래스(컴포넌트)는 생성 시 복제됩니다. 이 지정자는 서브클래스에 상속됩니다.
`DependsOn=(ClassName1, ClassName2, ...)`	나열된 모든 클래스는 이 클래스에 앞서 컴파일됩니다. ClassName 은 같은 (또는 기존) 패키지의 클래스를 지정해야 합니다. 다중 종속 클래스 지정은 단일 `DependsOn` 줄을 쉼표로 구분해서, 또는 각 클래스마다 별도의 `DependsOn` 줄을 사용해서 합니다. 컴파일러는 이미 컴파일된 클래스에 있는 것에 대해서만 알고있기 때문에, 다른 클래스에서 선언된 구조체 또는 enum 을 사용하는 클래스의 경우 중요합니다.
`Deprecated`	이 클래스는 폐기되어서 이 클래스의 오브젝트는 시리얼라이즈에 저장되지 않습니다. 이 지정자는 서브클래스에 상속됩니다.
`DontAutoCollapseCategories=(Category, Category, ...)`	부모 클래스에서 상속된 나열 카테고리에 대해 `AutoCollapseCategories` 지정자를 무효화시킵니다.
`DontCollapseCategories`	베이스 클래스에서 상속된 `CollapseCatogories` 지정자를 무효화시킵니다.
`EditInlineNew`	이 클래스의 오브젝트는 기존 애셋에서 참조되는 것과 반대로, 언리얼 에디터 프로퍼티 창에서 생성할 수 있음을 나타냅니다. 기본 작동방식은, 기존 오브젝트로의 레퍼런스만 프로퍼티 창을 통해 할당할 수 있습니다. 이 지정자는 모든 자식 클래스에 전파되며, 자식 클래스에서는 `NotEditInlineNew` 지정자로 덮어쓸 수 있습니다.
`HideCategories=(Category1, Category2, ...)`	이 클래스의 오브젝트에 대해 언리얼 에디터 프로퍼티 창에서 숨겨야 하는 카테고리를 하나 이상 나열합니다. 카테고리 없이 선언된 프로퍼티를 숨기려면, 변수를 선언한 것과 같은 클래스 이름을 사용하면 됩니다. 이 지정자는 자식 클래스에 전파됩니다.
`HideDropdown`	이 클래스가 언리얼 에디터 프로퍼티 창에 콤보 박스로 나타나지 않도록 합니다.
`HideFunctions=(Category1, Category2, ...)`	프로퍼티 뷰어에서 지정된 카테고리의 모든 함수를 숨깁니다.
`HideFunctions=FunctionName`	프로퍼티 뷰어에서 해당 이름의 함수를 숨깁니다.
`Intrinsic`	이 클래스는 C++ 에서 바로 전언하여 언리얼 헤더 툴 이 생성하는 상용구가 없음을 나타냅니다. 새 클래스에는 사용하지 마세요.
`MinimalAPI`	클래스의 형 정보만 다른 모슐이 사용할 수 있도록 노출시킵니다. 이 클래스는 형변환이 가능하지만, 그 함수는 (인라인 메서드를 제외하고) 호출할 수 없습니다. 다른 모듈에서 접근할 수 없는 함수 전부가 필요치 않은 클래스에 대해 모든 것을 익스포트하지 않아 컴파일 시간이 향상됩니다.
`NoExport`	이 클래스의 선언은 헤더 생성기의 자동 생성 C++ 헤더 파일에 포함시키지 말아야 함을 나타냅니다. C++ 클래스 선언은 별도의 헤더 파일에 수동 정의해야 합니다. 네이티브 클래스에만 유효합니다. 새 클래스에는 사용하지 마세요.
`NonTransient`	베이스 클래스에서 상속된 `Transient` 지정자를 무효화시킵니다.
`NotBlueprintable`	이 클래스는 블루프린트 생성을 위한 베이스 클래스로 사용할 수 없음을 나타냅니다. 기본값이며, 서브클래스에 상속됩니다.
`NotPlaceable`	베이스 클래스에서 상속된 `Placeable` 지정자를 무효화시킵니다. 이 클래스의 오브젝트는 에디터의 레벨, UI 씬, 블루프린트에 배치할 수 없음을 나타냅니다.
`PerObjectConfig`	이 클래스의 환경설정 정보는 오브젝트별로 저장되며, 각 오브젝트에는 `.ini` 파일에 섹션이 있고 그 이름은 오브젝트를 따서 `[ObjectName ClassName]` 포맷으로 합니다. 이 지정자는 자식 클래스에 전파됩니다.
`Placeable`	이 클래스는 에디터에서 생성할 수 있고 (클래스 유형에 따라) 레벨, UI 씬, 블루프린트에 배치할 수 있음을 나타냅니다. 이 옵션은 모든 자식 클래스에 전파되며, 자식 클래스에서는 `NotPlaceable` 지정자로 덮어쓸 수 있습니다.
`ShowCategories=(Category1, Category2, ...)`	나열된 카테고리에 대해서 (베이스 클래스에서 상속된) `HideCategories` 지정자를 무효화시킵니다.
`ShowFunctions=(Category1, Category2, ...)`	프로퍼티 뷰어에서 나열된 카테고리 내 모든 함수를 표시합니다.
`ShowFunctions=FunctionName`	프로퍼티 뷰어에서 나열된 함수를 표시합니다.
`Transient`	이 클래스에 속하는 오브젝트는 디스크에 저장되지 않습니다. 플레이어나 창처럼 속성상 지속적이지 않은 네이티브 클래스같은 것과 함께 쓸 때 좋습니다. 이 지정자는 자식 클래스에 전파되며, `NonTransient` 지정자로 덮어쓸 수 있습니다.
`Within=OuterClassName`	이 클래스의 오브젝트는 `OuterClassName` 오브젝트의 인스턴스 외부에 존재할 수 없습니다. 즉 이 클래스의 오브젝트를 생성하는 것은 `OuterClassName` 인스턴스를 `Outer` 오브젝트로 제공해야 한다는 뜻입니다.

메타데이터 지정자

메타데이터 지정자 사용법은 일반적인 클래스, 함수, 인터페이스 지정자와는 다릅니다.

클래스는 다음과 같은 메타태그 지정자를 사용할 수 있습니다:


클래스 메타 태그	효과
`BlueprintSpawnableComponent`	존재하면, 블루프린트가 컴포넌트 클래스를 스폰시킬 수 있습니다.
`BlueprintThreadSafe`	블루프린트 함수 라이브러리에서만 유효합니다. 이 지정자는 이 클래스의 함수를 애니메이션 블루프린트의 비게임 스레드에서 호출가능한 것으로 마킹합니다.
`ChildCannotTick`	액터 및 컴포넌트 클래스에 사용됩니다. 네이티브 클래스가 틱을 할 수 없으면, 이 액터 또는 컴포넌트를 기반 블루프린트 생성 클래스도, 심지어 `bCanBlueprintsTickByDefault` 가 true 라도 절대 틱이 되지 않습니다.
`ChildCanTick`	액터 및 컴포넌트 클래스에 사용됩니다. 네이티브 클래스가 틱을 할 수 없으면, 이 액터 또는 컴포넌트를 기반 블루프린트 생성 클래스는, `bCanBlueprintsTickByDefault` 가 false 라 할지라도 `bCanEverTick` 옵션을 덮어쓰도록 할 수 있습니다.
`DeprecatedNode`	비헤이비어 트리 노드에 대해, 클래스가 폐기되어 컴파일 시 경고가 표시됨을 나타냅니다.
`DeprecationMessage="Message Text"`	클래스가 폐기되면, 그것을 사용하는 블루프린트를 컴파일하려 할 때 표준 폐기 경고에 이 메시지가 추가됩니다.
`DisplayName="Blueprint Node Name"`	블루프린트의 이 노드 이름은 코드 생성 이름이 아닌 여기 제공된 값으로 대체됩니다.
`DontUseGenericSpawnObject`	블루프린트의 Generic Create Object 노드를 사용하여 클래스의 오브젝트를 스폰하지 않습니다. 이 지정자는 Actor 도 ActorComponent 도 아닌 BlueprintType 클래스에만 의미가 있습니다.
`ExposedAsyncProxy`	Async Task 노드에 이 클래스의 프록시 오브젝트를 노출시킵니다.
`IgnoreCategoryKeywordsInSubclasses`	클래스의 첫 서브클래스가 상속된 `ShowCategories` 및 `HideCategories` 지정자 전부를 무시하도록 만듭니다.
`IsBlueprintBase="true/false"`	이 클래스가 블루프린트 생성을 위한 베이스 클래스로 적합한지( 또는 아닌지)를 나타냅니다. `UCLASS` 지정자, `Blueprintable` 또는 'NotBlueprintable` 과 비슷합니다.
`KismetHideOverrides="Event1, Event2, .."`	덮어쓰기를 허용하지 않을 블루프린트 이벤트 목록입니다.
`ProhibitedInterfaces="Interface1, Interface2, .."`	클래스와 호환되지 않는 인터페이스 목록입니다.
`RestrictedToClasses="Class1, Class2, .."`	블루프린트 함수 라이브러리 클래스에서 목록의 클래스 사용을 제한시킵니다.
`ShortToolTip="Short tooltip"`	부모 클래스 선택기 대화창처럼 전체 툴팁 표시가 버거운 상황에서 사용할 짧은 툴팁입니다.
`ShowWorldContextPin`	이 클래스 소유 그래프에 배치된 블루프린트 노드는 월드 컨텍스트 핀을 반드시 표시해야 합니다. 이 클래스 오브젝트를 월드 컨텍스트로 사용할 수 없어서, 보통 숨겨진 경우에도 마찬가지입니다.
`UsesHierarchy`	클래스가 계층형 데이터를 사용함을 나타냅니다. 디테일 패널의 계층형 편집 기능 인스턴싱에 사용합니다.
`ToolTip="Hand-written tooltip"`	코드 코멘트에서 자동 생성되는 툴팁을 덮어씁니다.

태그

UCLASS

Specifiers

언리얼 엔진 문서의 미래를 함께 만들어주세요! 더 나은 서비스를 제공할 수 있도록 문서 사용에 대한 피드백을 주세요.

설문조사에 참여해 주세요

취소