WindowConfigurations.Add 메서드

아티클
08/09/2011

현재 창 배열을 기반으로 명명된 새 창 구성을 만들어 WindowConfigurations 컬렉션에 추가하고 나중에 다시 호출할 수 있도록 유지합니다.

네임스페이스: EnvDTE
어셈블리: EnvDTE(EnvDTE.dll)

구문

‘선언
Function Add ( _
    Name As String _
) As WindowConfiguration

WindowConfiguration Add(
    string Name
)

WindowConfiguration^ Add(
    [InAttribute] String^ Name
)

abstract Add : 
        Name:string -> WindowConfiguration

function Add(
    Name : String
) : WindowConfiguration

매개 변수

Name
형식: System.String
필수적 요소로서,새 창 구성의 이름을 나타내는 문자열입니다.

반환 값

형식: EnvDTE.WindowConfiguration
WindowConfiguration 개체입니다.

설명

Visual Studio 환경에서 현재 창 레이아웃을 명명된 창 구성으로 저장할 수 있습니다. Add 메서드를 사용하면 Apply 메서드를 사용하여 나중에 다시 호출할 수 있도록 이 구성을 저장할 수 있습니다.

예제

Sub AddExample(ByVal dte As DTE)
    ' Set references to all necessary objects.
    Dim colWinConfig As WindowConfigurations
    Dim objWinConfig As WindowConfiguration

    colWinConfig = dte.WindowConfigurations

    MsgBox("Number of configurations: " & colWinConfig.Count)
    ' List all saved named window configurations.
    FillMsg(colWinConfig)
    ' Create a new window configuration.
    objWinConfig = colWinConfig.Add("NewLayout")
    FillMsg(colWinConfig)
    ' Get rid of the new window configuration.
    objWinConfig.Delete()
    MsgBox("Number of configurations: " & colWinConfig.Count)
    FillMsg(colWinConfig)
End Sub

Sub FillMsg(ByVal colWinConfig As Object)
    ' Lists all currently available named window configurations.
    Dim lCtr As Integer
    Dim strMsg As String

    For lCtr = 1 To colWinConfig.Count
    strMsg = strMsg & "Configuration name " & lCtr & ": " & _
    colWinConfig.Item(lCtr).Name & vbCr
    Next lCtr
    strMsg = "Current Configurations: " & vbCr & strMsg
    MsgBox(strMsg)
End Sub

void AddExample(_DTE dte)
{
    // Set references to all necessary objects.
    WindowConfigurations colWinConfig; 
    WindowConfiguration objWinConfig;

    colWinConfig = dte.WindowConfigurations;
    MessageBox.Show("Number of configurations: " + colWinConfig.Count);
    // List all saved named window configurations.
    FillMsg(colWinConfig);
    // reate a new window configuration.
    objWinConfig = colWinConfig.Add("NewLayout");
    FillMsg(colWinConfig);
    // Get rid of the new window configuration.
    objWinConfig.Delete();
    MessageBox.Show("Number of configurations: " + colWinConfig.Count);
    FillMsg(colWinConfig);
}

void FillMsg(WindowConfigurations colWinConfig )
{
    // Lists all currently available named window configurations.
    int lCtr;
    string strMsg = null;

    for (lCtr = 1; lCtr < colWinConfig.Count + 1; lCtr ++)
    {
        strMsg = strMsg + "Configuration name " + lCtr + ": " + 
        colWinConfig.Item(lCtr).Name + "\n"; 
    }
    strMsg = "Current Configurations: \n" + strMsg;
    MessageBox.Show(strMsg);
}