속성 창 필드 및 인터페이스

아티클
06/19/2023

속성 창에 표시되는 정보를 결정하기 위한 선택 모델은 IDE에 포커스가 있는 창을 기반으로 합니다. 모든 창과 선택한 창 내의 개체는 선택 컨텍스트 개체를 전역 선택 컨텍스트로 푸시할 수 있습니다. 해당 창에 포커스가 있을 때 환경은 창 프레임의 값으로 전역 선택 컨텍스트를 업데이트합니다. 포커스가 변경되면 선택 컨텍스트도 변경합니다.

IDE에서 선택 항목 추적

IDE가 소유한 창 프레임 또는 사이트에는 STrackSelection이라는 서비스가 있습니다. 다음 단계는 사용자가 포커스를 다른 열린 창으로 변경하거나 솔루션 탐색기에서 다른 프로젝트 항목을 선택하여 발생하는 속성 창에 표시된 콘텐츠를 변경하기 위해 선택 항목의 변경을 구현하는 방법을 보여 줍니다.

선택한 창에 있는 VSPackage에 의해 만들어진 개체는 QueryService을 호출하여 STrackSelection이 ITrackSelection을 호출하도록 합니다.
선택한 창에서 제공하는 선택 컨테이너는 자체 ISelectionContainer 개체를 만듭니다. 선택 영역이 변경되면 VSPackage는 속성 창을 포함하여 환경의 모든 수신기에 변경 내용을 알리기 위해 OnSelectChange을 호출합니다. 또한 새 선택 항목과 관련된 계층 구조 및 항목 정보에 대한 액세스를 제공합니다.
OnSelectChange을 호출하고 VSHPROPID_BrowseObject 매개 변수에서 선택한 계층 구조 항목을 전달하면 ISelectionContainer 개체가 채워집니다.
IDispatch 인터페이스에서 파생된 개체는 요청된 항목의 __VSHPROPID.VSHPROPID_BrowseObject에 대해 반환되고 환경은 이를 ISelectionContainer로 래핑합니다(다음 단계 참조). 호출이 실패하면 환경에서 IVsHierarchy::GetProperty에 대한 두 번째 호출을 수행하여 계층 구조 항목이 제공하는 선택 컨테이너 __VSHPROPID.VSHPROPID_SelContainer를 전달합니다.

프로젝트 VSPackage는 이를 구현하는 환경 제공 창 VSPackage(예: 솔루션 탐색기)가 대신 ISelectionContainer를 생성하기 때문에 ISelectionContainer를 만들지 않습니다.
환경은 속성 창을 채울 IDispatch 인터페이스를 기반으로 개체를 가져오기 위해 ISelectionContainer의 메서드를 호출합니다.

속성 창의 값이 변경되면 VSPackages는 IVsTrackSelectionEx::OnElementValueChangeEx 및 IVsTrackSelectionEx::OnSelectionChangeEx를 구현하여 요소 값의 변경 내용을 보고합니다. 그런 다음, 환경은 IVsUIShell 또는 IConnectionPointContainer를 호출하여 속성 창에 표시된 정보를 속성 값과 동기화된 상태로 유지합니다. 자세한 내용은 속성 창에서 속성 값 업데이트를 참조하세요.

솔루션 탐색기에서 다른 프로젝트 항목을 선택하여 해당 항목과 관련된 속성을 표시하는 것 외에도 속성 창에서 제공되는 드롭다운 목록을 사용하여 양식 또는 문서 창 내에서 다른 개체를 선택할 수도 있습니다. 자세한 내용은 속성 창 개체 목록을 참조하세요.

정보가 속성 창 그리드에 표시되는 방식을 사전순에서 범주로 변경할 수 있으며, 가능한 경우 속성 창에서 적절한 단추를 클릭하여 선택한 개체에 대한 속성 페이지를 열 수도 있습니다. 자세한 내용은 속성 창 단추 및 속성 페이지를 참조하세요.

마지막으로 속성 창 하단에는 속성 창 그리드에서 선택한 필드에 대한 설명도 포함됩니다. 자세한 내용은 속성 창에서 필드 설명 가져오기를 참조하세요.

속성 창에서 속성 값을 업데이트합니다.

속성 창이 속성 값 변경과 동기화 상태를 유지하도록 하는 방법에는 두 가지가 있습니다. 첫 번째는 IVsUIShell 인터페이스를 호출하는 방법입니다. 이 인터페이스는 환경에서 제공하는 도구 및 문서 창의 생성 및 액세스를 포함한 기본적인 창 관리 기능에 대한 액세스를 제공합니다. 다음 단계에서 이 동기화 프로세스를 설명합니다.

IVsUIShell을 사용하여 속성 값 업데이트

IVsUIShell 인터페이스를 사용하여 속성 값을 업데이트하려면

VSPackages, 프로젝트 또는 편집기가 도구 또는 문서 창을 만들거나 열거해야 할 때 언제라도 IVsUIShell을 호출합니다(SVsUIShell 서비스를 통해).
RefreshPropertyBrowser를 구현하여 IConnectionPointContainer 구현 및 OnChanged 이벤트 발생 없이 속성 창을 프로젝트(또는 속성 창이 탐색하는 다른 모든 선택된 개체)의 속성 변경과 동기화합니다.
IVsHierarchy 메서드 AdviseHierarchyEvents 및 UnadviseHierarchyEvents를 구현하여 계층이 IConnectionPointContainer를 구현할 필요 없이 계층 이벤트의 클라이언트 알림을 설정 및 비활성화합니다.

IConnection을 사용하여 속성 값 업데이트

속성 창과 속성 값 변경의 동기화를 유지하는 두 번째 방법은 연결 가능 개체에 IConnection 를 구현하여 송신 인터페이스가 있음을 나타내는 것입니다. 속성 이름을 지역화하려는 경우에는 ICustomTypeDescriptor에서 개체를 파생하세요. ICustomTypeDescriptor 구현은 반환되는 속성 설명자를 수정하고 속성의 이름을 변경할 수 있습니다. 설명을 지역화하려면 DescriptionAttribute에서 파생되는 특성을 만들고 설명 속성을 재정의하세요.

IConnection 인터페이스 구현 시 고려 사항

IConnection는 IEnumConnectionPoints 인터페이스를 통해 열거자 하위 개체에 대한 액세스를 제공합니다. 또한 각각 IConnectionPoint 인터페이스를 구현하는 모든 연결점 하위 개체에 대한 액세스도 제공합니다.
모든 찾아보기 개체가 IPropertyNotifySink 이벤트 구현을 담당합니다. 속성 창은 IConnection를 통해 설정된 이벤트에 대해 통지합니다.
연결점은 Advise의 구현에서 허용되는 연결 수(하나 또는 그 이상)를 제어합니다. 하나의 인터페이스만 허용하는 연결점은 EnumConnections 메서드에서 E_NOTIMPL을 반환할 수 있습니다.
클라이언트는 IConnection 인터페이스를 호출하여 IEnumConnectionPoints 인터페이스를 통해 열거자 하위 개체에 대한 액세스를 얻습니다. 그러면 IEnumConnectionPoints 인터페이스를 호출하여 각 송신 인터페이스 ID(IID)에 대한 연결점을 열거할 수 있습니다.
또한 IConnection를 호출하여 각 송신 IID에 대한 IConnectionPoint 인터페이스를 통해 연결점 하위 개체에 대한 액세스를 얻을 수도 있습니다. IConnectionPoint 인터페이스를 통해 클라이언트는 연결 가능한 개체 및 클라이언트 자체 동기화로 자문 루프를 시작하거나 종료합니다. 클라이언트는 IConnectionPoint 인터페이스를 호출하여 알고 있는 연결을 열거하기 위해 IEnumConnections 인터페이스로 열거자 개체를 가져올 수도 있습니다.

속성 창에서 필드 설명 가져오기

속성 창 맨 아래 설명 영역에는 선택한 속성 필드와 관련된 정보가 표시됩니다. 이 기능은 기본적으로 켜져 있습니다. 설명 필드를 숨기려면 속성 창을 오른쪽 단추로 클릭하고 설명을 클릭합니다. 그러면 메뉴 창에서 설명 제목 옆의 확인 표시가 사라집니다. 같은 방법으로 설명 을 다시 토글하면 필드가 표시됩니다.

설명 필드의 정보는 ITypeInfo에서 가져옵니다. 각 메서드, 인터페이스, coclass 등은 형식 라이브러리에 지역화되지 않은 helpstring 특성을 가질 수 있습니다. 속성 창은 GetDocumentation에서 문자열을 검색합니다.

지역화된 도움말 문자열을 지정하려면

형식 라이브러리( helpstringdll )의 라이브러리 문에typelib특성을 추가합니다.

참고 항목

형식 라이브러리가 개체 라이브러리 (.olb) 파일인 경우 이 단계는 선택 사항입니다.
문자열에 대한 지정 helpstringcontext 특성을 지정합니다. helpstring 특성을 지정할 수도 있습니다.

이러한 특성은 실제 .chm 파일 도움말 항목에 포함된 helpfile 및 helpcontext 특성과 별개입니다.

강조 표시된 속성 이름에 대해 표시할 설명 정보를 검색하기 위해 속성 창이 선택된 속성에 대한 GetDocumentation2을 호출하여 출력 문자열에 대해 원하는 lcid 특성을 지정합니다. 내부적으로 ITypeInfo2이(가) helpstringdll 특성에 지정된 .dll 파일을 찾아서 지정된 컨텍스트 및 lcid 특성으로 이 .dll 파일에 대해 DLLGetDocumentation을(를) 호출합니다.

DLLGetDocumentation 의 서명 및 구현:

STDAPI DLLGetDocumentation
(
   ITypeLib * /* ptlib */,
   ITypeInfo * /* ptinfo */,
   LCID /* lcid */,
   DWORD dwCtx,
   BSTR * pbstrHelpString
);

DLLGetDocumentation 함수는 DLL에 대한.def 파일에 정의된 내보내기여야 합니다.

내부적으로 .olb 파일이 생성되는데 실제로 이것은 DLL입니다. 이 DLL에는 형식 라이브러리(.tlb) 파일 리소스 하나와 내보내기 함수 DLLGetDocumentation하나가 있습니다.

.olb 파일의 경우 .tlb 파일 자체를 포함하는 것과 같은 파일이므로 helpstringdll 특성은 선택 사항입니다.

따라서 설명 창에 문자열이 나타나도록 하려면 최소한 형식 라이브러리에서 helpstring 특성을 지정해야 합니다. 이러한 문자열을 지역화하려면 helpstringdll (선택 사항) 특성 및 helpstringcontext (필수) 특성을 지정하고 DLLGetDocumentation을(를) 구현해야 합니다.

idl의 helpstringcontext 특성 및 DLLGetDocumentation을(를) 통해 지역화된 정보를 가져올 경우 추가 인터페이스를 구현할 필요가 없습니다.

속성의 지역화된 이름 및 설명을 가져오는 또 하나의 방법은 GetLocalizedPropertyInfo 구현입니다. 이 방법으로 구현하는 자세한 내용은 Properties Window Fields and Interfaces에서 참조하세요.

참고 항목

속성 확장

다음을 통해 공유