[VCL] TIP/A component class named <name> already exists

시작하면서

RAD Studio에서 프레임을 상속받아 여러 번 생성하고 재사용하려 할 때, "A component class named already exists" 오류가 발생했습니다.

 

이번 포스팅에서는 이 문제의 정의, 원인, 해결 방법, 그리고 프레임과 폼의 차이와 목적에 대해 알아보겠습니다.

문제 정의

프레임은 여러 폼에서 재사용할 수 있는 UI 구성 요소입니다. 그러나 동일한 이름을 가진 프레임을 여러 번 생성하려고 하면, 컴포넌트 클래스 이름 충돌로 인해 오류가 발생합니다. 이 오류는 프레임의 Name 속성이 프로젝트 내에서 유일해야 한다는 규칙 때문에 발생합니다.

문제 원인

프레임과 폼의 Name 속성은 프로젝트 내에서 유일해야 합니다. 이는 컴포넌트가 런타임에 식별될 수 있도록 하기 위함입니다. 만약 두 개 이상의 프레임이나 폼이 동일한 이름을 갖게 되면, 런타임에서 어떤 컴포넌트를 참조해야 할지 혼란스러워지게 됩니다. 이로 인해 다음과 같은 오류가 발생합니다:

A component class named <name> already exists

해결 방법

이 문제를 해결하기 위해 프레임의 생성자에서 strName을 매개변수로 받아 Name 속성을 유일하게 유지하도록 설정합니다.

프레임 클래스 정의

// MyFrame.h
class TMyFrame : public TFrame {
public:
    __fastcall TMyFrame(TComponent* Owner, const String strName);
};

// MyFrame.cpp
__fastcall TMyFrame::TMyFrame(TComponent* Owner, const String strName)
    : TFrame(Owner) {
    this->Name = strName; // 유일한 이름 설정
}

main.cpp에서 프레임 사용

프레임을 여러 번 생성할 때, 각 프레임의 이름을 다르게 지정하여 초기화합니다.

// main.cpp
TMyFrame *frame1 = new TMyFrame(this, "MyFrame1");
TMyFrame *frame2 = new TMyFrame(this, "MyFrame2");

// 추가적인 프레임 생성
TMyFrame *frame3 = new TMyFrame(this, "MyFrame3");

// 프레임을 폼에 추가
frame1->Parent = this;
frame2->Parent = this;
frame3->Parent = this;

이렇게 하면 각 프레임이 유일한 이름을 가지게 되어, 위의 오류를 피할 수 있습니다.

마무리하면서

프레임과 폼

프레임은 다른 컴포넌트와 함께 사용될 수 있는 UI 구성 요소입니다. 여러 폼에서 재사용할 수 있도록 설계되었습니다. 공통적인 UI 요소를 캡슐화하여 코드의 재사용성을 높이고, 유지 보수를 용이하게 합니다.

폼은 사용자 인터페이스를 구성하는 기본 단위로, 애플리케이션의 주요 화면을 나타냅니다. 애플리케이션의 사용자 인터페이스를 구성하고, 사용자와의 상호작용을 처리합니다.