다음을 통해 공유


속성 추가 마법사, 이름

이 마법사를 사용하면 속성을 인터페이스에 추가할 수 있습니다.

  • 속성 형식
    추가하는 속성의 형식을 설정합니다.MFC dispinterface의 경우, 사용자 고유의 형식을 지정하거나 미리 정의된 목록에서 형식을 선택합니다.속성을 스톡 구현으로 지정하면 속성 형식은 스톡 형식으로 설정되고 변경할 수 없게 됩니다.

  • 속성 이름
    속성 이름을 설정합니다.ActiveX 컨트롤에 연결된 MFC dispinterface의 경우, 사용자 고유의 이름을 지정하거나 미리 정의된 목록에서 스톡 속성 이름을 선택할 수 있습니다.사용자 고유의 속성 이름을 지정하면 스톡 구현 형식은 사용할 수 없습니다.목록에 있는 속성에 대한 자세한 설명은 스톡 속성을 참조하십시오.

    인터페이스 형식

    설명

    ATL 이중 인터페이스, 사용자 지정 인터페이스 및 로컬 사용자 지정 인터페이스

    속성 이름을 지정합니다.

    MFC dispinterface, MFC ActiveX 컨트롤 dispinterface

    속성 이름을 지정하거나 목록에서 스톡 속성을 선택합니다.목록에서 속성을 선택하면 해당 값이 속성 형식 상자에 나타납니다.구현 형식에서 선택한 항목에 따라 이 형식을 변경할 수 있습니다.

  • 반환 형식
    ATL 인터페이스 전용.속성에 대한 반환 형식을 설정합니다.이중 인터페이스의 경우, HRESULT가 항상 반환 형식이 되며 이 상자는 사용할 수 없게 됩니다.사용자 지정 인터페이스의 경우 목록에서 반환 형식을 선택할 수 있습니다.HRESULT는 표준적인 방법으로 오류를 반환하므로 역시 이 반환 형식을 사용하는 것이 좋습니다.

  • 변수 이름
    MFC dispinterface 전용.구현 형식에서 멤버 변수를 지정한 경우에만 사용할 수 있습니다.속성이 연결된 멤버 변수의 이름을 설정합니다.기본적으로 이 변수 이름은 m_PropertyName으로 설정됩니다.이 이름은 변경할 수 있습니다.

  • 알림 함수
    MFC dispinterface 전용.구현 형식에서 멤버 변수를 지정한 경우에만 사용할 수 있습니다.속성이 변경된 경우 호출되는 알림 함수의 이름을 설정합니다.기본적으로 알림 함수의 이름은 OnPropertyNameChanged로 설정됩니다.이 이름은 변경할 수 있습니다.

  • Get 함수
    MFC dispinterface에서 사용.구현 형식에서 Get/Set 메서드를 지정한 경우에만 사용할 수 있습니다.속성을 가져오는 함수의 이름을 설정합니다.기본적으로 Get 함수의 이름은 GetPropertyName으로 설정됩니다.이 이름은 변경할 수 있습니다.이 이름을 삭제하면 GetNotSupported 함수가 인터페이스 디스패치 맵에 삽입됩니다.GetPropertyName 함수는 속성을 읽을 수 있는 속성으로 지정합니다.

  • Set 함수
    MFC dispinterface 전용.구현 형식에서 Get/Set 메서드를 지정한 경우에만 사용할 수 있습니다.속성을 가져오는 함수의 이름을 설정합니다.기본적으로 Set 함수의 이름은 SetPropertyName으로 설정됩니다.이 이름은 변경할 수 있습니다.이 이름을 삭제하면 SetNotSupported 함수가 인터페이스 디스패치 맵에 삽입됩니다.SetPropertyName 함수는 속성을 쓰기 가능한 속성으로 지정합니다.

  • 구현 형식
    MFC dispinterface 전용.추가하는 속성을 구현하는 방법을 지정합니다.

    구현 형식

    설명

    스톡

    속성 이름에서 선택한 속성에 스톡 구현을 지정하며,기본값입니다.자세한 내용은 스톡 속성을 참조하십시오.

    스톡을 지정하면 속성 형식, 매개 변수 형식매개 변수 이름이 흐릿하게 표시되어 사용할 수 없게 됩니다.

    멤버 변수

    속성이 멤버 변수로 추가되도록 지정합니다.사용자 지정 속성이나 대부분의 스톡 속성을 멤버 변수로 추가할 수 있습니다.Caption, hWndText 속성에 멤버 변수를 지정할 수 없습니다.

    변수 이름알림 함수에서 기본 이름을 지정합니다.이 이름은 변경할 수 있습니다.

    Get/Set 메서드

    기본적으로 속성이 GetPropertyName 및 SetPropertyName 함수로 추가되도록 지정합니다.이 이름은 Get 함수Set 함수에 나타납니다.

    Get 함수에 사용할 값을 전달하는 기본 속성 형식을 변경할 수 있습니다.Get 및 Set 함수에 사용할 매개 변수를 지정할 수 있습니다.

  • Get 함수
    ATL 인터페이스에서 사용.속성을 읽을 수 있는 속성으로 설정합니다. 즉, 이 함수는 개체에서 이 속성을 검색할 수 있도록 Get 메서드를 만듭니다.Get, Put 또는 두 가지 모두를 선택해야 합니다.

  • Put 함수
    ATL 인터페이스 전용.속성을 쓰기 가능한 속성으로 설정합니다. 즉, 이 함수는 개체에서 이 속성을 설정하거나 "출력"할 수 있도록 Put 메서드를 만듭니다.Get, Put 또는 두 가지 모두를 선택해야 합니다.이 옵션을 선택하면 다음 두 가지 방법 중 하나를 사용하여 메서드를 구현할 수 있습니다.

    옵션

    설명

    PropPut

    propput 함수는 개체의 복사본을 반환합니다.이 옵션은 기본값이며 속성을 쓰기 가능한 속성으로 만드는 가장 일반적인 방법입니다.

    PropPutRef

    PropPutRef 함수는 개체 자체의 복사본을 반환하지 않고 개체에 대한 참조를 반환합니다.큰 구조체나 배열과 같이 초기화 오버헤드가 있을 수 있는 개체에 대해 이 옵션을 사용하십시오.

  • 매개 변수 특성
    ATL 인터페이스 전용.매개 변수 이름에 의해 지정되는 매개 변수가 in이거나 out인지, inout 모두인지, 또는 없음인지를 설정합니다.

    옵션

    설명

    in

    호출하는 프로시저에서 호출된 프로시저로 매개 변수가 전달됩니다.

    out

    호출된 프로시저에서 호출하는 프로시저로(서버에서 클라이언트로) 포인터 매개 변수가 반환됩니다.

  • 매개 변수 형식
    매개 변수의 데이터 형식을 설정합니다.목록에서 형식을 선택합니다.

  • 매개 변수 이름
    속성에 매개 변수가 있을 경우, 속성에 추가하는 매개 변수의 이름을 설정합니다.추가를 클릭하면 매개 변수 목록에 매개 변수 이름이 나타납니다.

  • 매개 변수 목록
    속성에 추가되는 특성 목록을 표시합니다.목록의 각 항목은 매개 변수 이름, 매개 변수 형식 및 특성으로 구성되어 있습니다.추가제거를 사용하여 목록을 업데이트할 수 있습니다.

  • Add
    매개 변수 이름매개 변수 형식에서 지정한 매개 변수를 매개 변수 목록에 추가합니다.매개 변수를 목록에 추가하려면 추가를 클릭해야 합니다.

  • Remove
    선택한 매개 변수를 매개 변수 목록에서 제거합니다.

  • 기본 속성
    MFC dispinterface 전용.이 속성을 인터페이스의 기본값으로 설정합니다.인터페이스에는 하나의 기본 속성만 있을 수 있습니다. 기본 속성이 지정되면, 인터페이스에 추가한 다른 모든 속성에 이 상자를 사용할 수 없습니다.

참고 항목

작업

속성 추가(Visual C++)

인터페이스 구현(Visual C++)

참조

속성 추가 마법사, IDL 특성