delegate

언리얼 델리게이트에 대해서 알아 보자.

리턴값이 없는 델리게이트

DECLARE_DELEGATE(DelegateName)
void Function()

DECLARE_DELEGATE_OneParam(DelegateName, Param1Type)
void Function(<Param1>)

DECLARE_DELEGATE_TwoParams(DelegateName, Param1Type, Param2Type)
void Function(<Param1>, <Param2>)

DECLARE_DELEGATE_<Num>Params(DelegateName, Param1Type, Param2Type, ...)
void Function(<Param1>, <Param2>, ...)

리턴값이 있는 델리게이트

DECLARE_DELEGATE_RetVal(RetValType, DelegateName)
< RetVal > Function()

DECLARE_DELEGATE_RetVal_OneParam(RetValType, DelegateName, Param1Type)
< RetVal > Function(<Param1>)

DECLARE_DELEGATE_RetVal_TwoParams(RetValType, DelegateName, Param1Type, Param2Type)
< RetVal > Function(<Param1>, <Param2>)

DECLARE_DELEGATE_RetVal_<Num>Params(RetValType, DelegateName, Param1Type, Param2Type, ...)
< RetVal > Function(<Param1>, <Param2>, ...)

네이티브 기능을 바인딩 할때 사용

DECLARE_DELEGATE
DECLARE_MULTICAST_DELEGATE

블루프린트 기능을 바인딩 할때 사용

파라미터 없고 리턴값 없는 기본 델리게이트

델리게이트 사용은 다음 4단계로 사용 할수 있다.

1. 델리게이트 선언
DECLARE_DELEGATE(VoidSimple);

2. 델리게이트 정의
VoidSimple VoidDeleFunc;

3. 바인딩
VoidDeleFunc.BindUFunction(this, FName("CallTest"));

4. 실행
VoidDeleFunc.Execute();

5. 바인딩 여부 검사
VoidDeleFunc.IsBound()

바인딩할 함수에 "UFUNCTION()"을 지정 하지 않으면 함수가 제대로 불려지지 않는다.
꼭 "UFUNCTION()"을 지정해야 한다.

//헤더 파일
DECLARE_DELEGATE(VoidSimple);

UCLASS()
class UMyGameInstance : public UGameInstance
{
public:
VoidSimple VoidDeleFunc;

private:
    UFUNCTION()
    void CallTest()
}

//CPP 파일
void UMyGameInstance::TestDelegate()
{
    VoidDeleFunc.BindUFunction(this, FName("CallTest"));
    if (VoidDeleFunc.IsBound())
       VoidDeleFunc.Execute();
}

void UMyGameInstance::CallTest()
{
    UE_LOG(LogTemp, Warning, TEXT("UMyGameInstance::CallTest-------------------"));
}

파라미터 없고 리턴값 없는 멀티 기본 델리게이트

멀티 기본 델리게이트 사용은 다음 4단계로 사용 할수 있다.
멀티 델리게이트는 여러개의 함수를 추가하고 실행하면 여러개의 함수가 실행된다.

1. 델리게이트 선언
DECLARE_MULTICAST_DELEGATE(MultiVoidSimple);

2. 델리게이트 정의
MultiVoidSimple MultiVoidDeleFunc;

3. 바인딩
MultiVoidDeleFunc.AddUFunction(this, FName("CallTest"));

4. 실행
MultiVoidDeleFunc.Broadcast();

5. 바인딩 여부 검사
MultiVoidDeleFunc.IsBound()

바인딩할 함수에 "UFUNCTION()"을 지정 하지 않으면 함수가 제대로 불려지지 않는다.
꼭 "UFUNCTION()"을 지정해야 한다.

//헤더 파일
DECLARE_MULTICAST_DELEGATE(MultiVoidSimple);

UCLASS()
class UMyGameInstance : public UGameInstance
{
public:
    MultiVoidSimple MultiVoidDeleFunc;

private:
    UFUNCTION()
    void CallTest()
}

//CPP 파일
void UMyGameInstance::TestDelegate()
{
    MultiVoidDeleFunc.AddUFunction(this, FName("CallTest"));
    if (MultiVoidDeleFunc.IsBound())
       MultiVoidDeleFunc.Broadcast();
}

void UMyGameInstance::CallTest()
{
    UE_LOG(LogTemp, Warning, TEXT("UMyGameInstance::CallTest-------------------"));
}

파라미터 없고 리턴값 없는 동적 기본 델리게이트

동적 델리게이트는 블루프린트의 기능에 사용 할수 있다.
동적 기본 델리게이트 사용은 다음 4단계로 사용 할수 있다.
동적 델리게이트는 여러개의 함수를 추가하고 실행하면 여러개의 함수가 실행된다.

1. 델리게이트 선언
DECLARE_DYNAMIC_DELEGATE(FVoidSimple);

동적 델리게이트는 델리게이트 선언시 "F"를 꼭 붙여야 한다.

2. 델리게이트 정의
FVoidSimple VoidDeleFunc;

3. 바인딩
VoidDeleFunc.BindDynamic(this, &UMyGameInstance::CallTest);

4. 실행
VoidDeleFunc.ExecuteIfBound();

ExecuteIfBound 함수는 바인딩 되어 있으면 실행하고, 바인딩 안되어 있으면 실행하지 않는다.
IsBound로 검사하고 Execute()것과 같은 기능을 한다.
반환값이 없는 델리게이트에 사용 할수 있다.

5. 바인딩 여부 검사
VoidDeleFunc.IsBound()

바인딩할 함수에 "UFUNCTION()"을 지정 하지 않으면 함수가 제대로 불려지지 않는다.
꼭 "UFUNCTION()"을 지정해야 한다.

//헤더 파일
DECLARE_DYNAMIC_DELEGATE(FVoidSimple);

UCLASS()
class UMyGameInstance : public UGameInstance
{
public:
    FVoidSimple VoidDeleFunc;

private:
    UFUNCTION()
    void CallTest()
}

//CPP 파일
void UMyGameInstance::TestDelegate()
{
    VoidDeleFunc.BindDynamic(this, &UMyGameInstance::CallTest);
    VoidDeleFunc.ExecuteIfBound();
}

void UMyGameInstance::CallTest()
{
    UE_LOG(LogTemp, Warning, TEXT("UMyGameInstance::CallTest-------------------"));
}

파라미터 없고 리턴값 없는 동적 멀티 기본 델리게이트

동적 델리게이트는 블루프린트의 기능에 사용 할수 있다.
동적 멀티 기본 델리게이트 사용은 다음 4단계로 사용 할수 있다.
동적 멀티 델리게이트는 여러개의 함수를 추가하고 실행하면 여러개의 함수가 실행된다.

1. 델리게이트 선언
DECLARE_DYNAMIC_MULTICAST_DELEGATE(FMultiVoidSimple);

동적 델리게이트는 델리게이트 선언시 "F"를 꼭 붙여야 한다.

2. 델리게이트 정의
FMultiVoidSimple dynaMultiVoidDeleFunc;

3. 바인딩
MultiVoidDeleFunc.AddDynamic(this, &UMyGameInstance::CallTest);

4. 실행
MultiVoidDeleFunc.Broadcast();

5. 바인딩 여부 검사
MultiVoidDeleFunc.IsBound()

바인딩할 함수에 "UFUNCTION()"을 지정 하지 않으면 함수가 제대로 불려지지 않는다.
꼭 "UFUNCTION()"을 지정해야 한다.

//헤더 파일
DECLARE_MULTICAST_DELEGATE(FMultiVoidSimple);

UCLASS()
class UMyGameInstance : public UGameInstance
{
public:
    FMultiVoidSimple MultiVoidDeleFunc;

private:
    UFUNCTION()
    void CallTest()
}

//CPP 파일
void UMyGameInstance::TestDelegate()
{
    MultiVoidDeleFunc.AddDynamic(this, &UMyGameInstance::CallTest);
    if (MultiVoidDeleFunc.IsBound())
       MultiVoidDeleFunc.Broadcast();
}

void UMyGameInstance::CallTest()
{
    UE_LOG(LogTemp, Warning, TEXT("UMyGameInstance::CallTest-------------------"));
}

참조)
언리얼 델리게이트 문서
언리얼 델리게이트 문서2