이 설명서는 보관되지만 유지 되지 않습니다.

DesignerActionItem 클래스

업데이트: 2007년 11월

스마트 태그 패널의 패널 항목을 나타내는 형식에 대한 기본 클래스를 제공합니다.

네임스페이스:  System.ComponentModel.Design
어셈블리:  System.Design(System.Design.dll)

public abstract class DesignerActionItem
public abstract class DesignerActionItem
public abstract class DesignerActionItem

DesignerActionItem 클래스는 스마트 태그 패널의 개별 패널 항목을 나타내는 클래스에 대한 추상 기본 클래스 역할을 합니다. 이 추상 기본 클래스는 메뉴와 비슷한 스마트 태그용 UI(사용자 인터페이스)를 나타냅니다. .NET Framework는 연결된 DesignerActionList 클래스의 일반 텍스트, 머리글 텍스트, 속성, 메서드와 디자이너 동사를 비롯하여 스마트 태그 패널 내의 여러 공용 엔트리를 나타내는 파생 클래스를 제공합니다.

대개 개별 패널 항목을 함께 그룹화하여 스마트 태그 패널을 구성하는 GetSortedActionItems 메서드를 포함하는 DesignerActionList에서 파생된 프로그래머 제공 클래스에 DesignerAction 기능이 정의되어 있습니다. DesignerActionPropertyItemDesignerActionMethodItem 형식은 DesignerActionList에서 파생된 클래스의 멤버와 연결되어 있으며 DesignerActionMethodItem 개체는 이 개체와 연결된 패널 항목을 사용자가 선택하면 활성화됩니다.

참고:

DesignerActionList에서 파생된 클래스의 멤버를 사용하여 폼과 대화 상자를 표시할 수 있습니다. 기본적으로 이러한 창의 부모가 스마트 태그 패널의 컨테이너 창이 됩니다. 이러한 자식 창을 명시적으로 다른 서비스나 창의 부모로 지정하면 항목이 제대로 표시되지 않습니다.

다음 코드 예제에서는 DesignerActionItem 개체의 컬렉션을 만드는 방법을 보여 줍니다.

스마트 태그 구현에 대한 전체 예제를 보려면 방법: Windows Forms 구성 요소에 스마트 태그 연결을 참조하십시오.

public override DesignerActionItemCollection GetSortedActionItems()
{
    DesignerActionItemCollection items = new DesignerActionItemCollection();

    //Define static section header entries.
    items.Add(new DesignerActionHeaderItem("Appearance"));
    items.Add(new DesignerActionHeaderItem("Information"));

    //Boolean property for locking color selections.
    items.Add(new DesignerActionPropertyItem("LockColors",
                     "Lock Colors", "Appearance",
                     "Locks the color properties."));
    if (!LockColors)
    {
        items.Add(new DesignerActionPropertyItem("BackColor",
                         "Back Color", "Appearance",
                         "Selects the background color."));
        items.Add(new DesignerActionPropertyItem("ForeColor",
                         "Fore Color", "Appearance",
                         "Selects the foreground color."));

        //This next method item is also added to the context menu 
        // (as a designer verb).
        items.Add(new DesignerActionMethodItem(this,
                         "InvertColors", "Invert Colors",
                         "Appearance",
                         "Inverts the fore and background colors.",
                          true));
    }
    items.Add(new DesignerActionPropertyItem("Text",
                     "Text String", "Appearance",
                     "Sets the display text."));

    //Create entries for static Information section.
    StringBuilder location = new StringBuilder("Location: ");
    location.Append(colLabel.Location);
    StringBuilder size = new StringBuilder("Size: ");
    size.Append(colLabel.Size);
    items.Add(new DesignerActionTextItem(location.ToString(),
                     "Information"));
    items.Add(new DesignerActionTextItem(size.ToString(),
                     "Information"));

    return items;
}


이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

.NET Framework

3.5, 3.0, 2.0에서 지원
표시: