다음을 통해 공유


ProvideToolboxItemsAttribute 클래스

정의

VSPackage를 구현하는 클래스에 이 특성을 적용하여 Visual Studio 도구 상자에 항목 집합을 제공하는 경우 선언합니다.

public ref class ProvideToolboxItemsAttribute : Microsoft::VisualStudio::Shell::RegistrationAttribute
[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
public class ProvideToolboxItemsAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute
[<System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)>]
type ProvideToolboxItemsAttribute = class
    inherit RegistrationAttribute
Public Class ProvideToolboxItemsAttribute
Inherits RegistrationAttribute
상속
ProvideToolboxItemsAttribute
특성

예제

아래 예제에서 클래스 MyPackage 에 적용된 특성은 "CF_XMLCODE" 및 "InPlaceMenuEditorMenu" 두 개의 클립보드 형식으로 의 Toolbox 항목 버전 1을 지원함을 나타냅니다.

[DefaultRegistryRoot("Software\\Microsoft\\VisualStudio\\8.0")]  
[ProvideToolboxItems(true, 1)]  
[ProvideToolboxFormat("CF_XMLCODE")]  
[ProvideToolboxFormat("InPlaceMenuEditorMenu")]  
[Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]  
internal sealed class MyPackage : Package  

설명

특성 컨텍스트

적용 대상 Package구현IVsPackage하여 VSPackage를 제공하는 클래스입니다.
반복 가능 No
필수 특성 ProvideToolboxFormatAttribute
잘못된 특성 없음

사용자가 클래스에서 Package제공하는 이 형식의 데이터 개체를 도구 상자로 끌어다 놓을 수 있도록 지원하는 데 필요한 를 구현 IVsPackage 하는 클래스 또는 파생 클래스에 이 특성을 적용합니다. 이 구현 클래스는 삭제 알림 자체를 처리해야 합니다.

이 특성은 등록 목적으로만 사용되며 런타임 시 코드가 작동하는 방식에는 영향을 주지 않습니다.

해당 생성자에 지정된 인수에 따라 이 특성은 VSPackage가 도구 상자 항목을 제공하지 않음을 나타낼 수 있습니다. 특성 ProvideToolboxFormatAttribute도구 상자 항목을 제공함을 나타내기 위해 클래스에 추가되는 경우 하나 이상의 인스턴스 ProvideToolboxFormatAttribute 도 추가해야 합니다.

이 특성은 를 사용하여 ProvideToolboxFormatAttribute 지정된 형식의 도구 상자 항목을 제공하는 것으로 VSPackage를 등록합니다.

이 특성이 도구 상자 항목이 제공되도록 지정하는 경우 VSPackage는 및 ToolboxUpgraded 이벤트를 처리 ToolboxInitialized 해야 합니다.

이 특성을 사용하는 모든 VSPackage는 및 ToolboxUpgraded 이벤트에 대한 ToolboxInitialized 처리기를 제공해야 합니다.

생성자

ProvideToolboxItemsAttribute(Int32)

VSPackage를 구현하는 클래스가 도구 상자 항목을 제공하는지 나타내는 새 instance ProvideToolboxItemsAttribute 만듭니다.

ProvideToolboxItemsAttribute(Int32, Boolean)

지정된 버전에 대한 의 ProvideToolboxItemsAttribute 새 instance 초기화합니다.

속성

NeedsCallBackAfterReset

이를 true로 설정하면 각 도구 상자가 다시 설정된 후 ToolboxInitialized 이벤트가 강제로 발생합니다. 이 기능은 패키지를 개발할 때 도구 상자가 매번 패키지에 항목 목록을 요청하도록 강제하는 데 사용할 수 있습니다(변경된 경우). 배송된 제품의 경우 캐시를 더 나은 성능에 사용할 수 있도록 false로 두는 것이 가장 좋습니다. 일부 시나리오(예: 캐시에 유지할 수 없는 항목 목록) 이 플래그를 true로 설정해야 할 수 있습니다.

TypeId

RegistrationAttribute 파생 클래스가 System.ComponentModel.TypeDescriptor.GetAttributes(...)에서 작동하도록 하려면 TypeID 속성을 재정의합니다. 이 속성에서 파생된 특성은 클래스에 적용할 수 있는 인스턴스에 대한 더 나은 제어가 필요한 경우에만 이 속성을 재정의해야 합니다.

(다음에서 상속됨 RegistrationAttribute)
Version

VSPackage에서 제공하는 도구 상자 항목의 버전을 반환하는 속성입니다.

메서드

GetPackageRegKeyPath(Guid)

VSPackage의 레지스트리 경로(애플리케이션의 레지스트리 루트를 기준으로)를 가져옵니다.

(다음에서 상속됨 RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)

VSPackage를 regpkg.exe 같은 외부 등록 도구에서 호출할 때 지정된 형식에 대한 도구 상자 항목 공급자로 등록합니다. 자세한 내용은 VSPackage 등록을 참조하세요.

Unregister(RegistrationAttribute+RegistrationContext)

메서드가 레지스트리에 Register(RegistrationAttribute+RegistrationContext) 적용한 변경 내용을 반대로 바꿉니다.

적용 대상