擴充 [狀態] 列

發行項
03/24/2017

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。

您可以使用 Visual Studio 的 [狀態] 列在 IDE 底部，以顯示資訊。

當您擴充 [狀態] 列時，您可以在四個區域中顯示資訊和 UI︰意見區域、進度列、動畫區域和設計工具區域。意見反應區域可讓您顯示文字並反白顯示的文字。進度列顯示短時間執行作業，例如儲存檔案的累加進度。動畫區域會顯示針對長時間執行作業或作業尚無法確定的長度，如建置方案中的多個專案的連續形成迴路動畫。與設計工具區域顯示的游標位置列和資料行數目。

您可以使用，以取得狀態列IVsStatusbar介面 (從SVsStatusbar服務)。此外，任何物件上的視窗框架的地方可註冊為用戶端物件的狀態列實作IVsStatusbarUser介面。每次啟動視窗時，Visual Studio 會查詢物件上的該視窗的地方IVsStatusbarUser介面。如果找到，則會呼叫SetInfo方法傳回的介面和物件可以更新從該方法內的狀態列。例如文件視窗中，可以使用SetInfo方法來更新設計工具區域中的資訊，當它們變成使用中時。

下列程序假設您了解如何建立 VSIX 專案，並加入自訂的功能表命令。如需資訊，請參閱建立擴充功能的功能表命令。

修改 [狀態] 列

此程序會示範如何設定並取得文字、顯示靜態文字，以及 [狀態] 列的意見區域中顯示的文字反白顯示。

讀取和寫入至 [狀態] 列

建立 VSIX 專案，名為TestStatusBarExtension ，並新增名為功能表命令TestStatusBarCommand。

在 TestStatusBarCommand.cs，取代命令處理常式方法程式碼 (MenuItemCallback) 下列︰

private void MenuItemCallback(object sender, EventArgs e)  
{  
    IVsStatusbar statusBar = (IVsStatusbar)ServiceProvider.GetService(typeof(SVsStatusbar));  

    // Make sure the status bar is not frozen  
    int frozen;  

    statusBar.IsFrozen(out frozen);  

    if (frozen != 0)   
    {  
        statusBar.FreezeOutput(0);  
    }  

    // Set the status bar text and make its display static.  
    statusBar.SetText("We just wrote to the status bar.");  

    // Freeze the status bar.  
    statusBar.FreezeOutput(1);  

    // Get the status bar text.   
    string text;  
    statusBar.GetText(out text);  
    System.Windows.Forms.MessageBox.Show(text);  

    // Clear the status bar text.  
    statusBar.FreezeOutput(0);  
    statusBar.Clear();  
}

編譯程式碼，並開始偵錯。
開啟工具功能表中的 Visual Studio 的實驗執行個體。按一下 [叫用 TestStatusBarCommand ] 按鈕。

您應該會看到現在讀取狀態列中的文字**「我們剛剛撰寫到狀態列。」** 而且會出現訊息方塊具有相同的文字。

更新進度列

在此程序中，我們將說明如何初始化及更新進度列。

開啟 TestStatusBarCommand.cs 檔案，並使用下列程式碼來取代 MenuItemCallback 方法︰

private void MenuItemCallback(object sender, EventArgs e)  
{  
    IVsStatusbar statusBar = (IVsStatusbar)ServiceProvider.GetService(typeof(SVsStatusbar));  
    uint cookie = 0;  
    string label = "Writing to the progress bar";  

    // Initialize the progress bar.  
    statusBar.Progress(ref cookie, 1, "", 0, 0);  

    for (uint i = 0, total = 20; i <= total; i++)  
    {  
        // Display progress every second.  
        statusBar.Progress(ref cookie, 1, label, i, total);  
        System.Threading.Thread.Sleep(1000);  
    }  

    // Clear the progress bar.  
    statusBar.Progress(ref cookie, 0, "", 0, 0);  
}

編譯程式碼，並開始偵錯。
開啟工具功能表中的 Visual Studio 的實驗執行個體。按一下 [叫用 TestStatusBarCommand ] 按鈕。

您應該會看到現在讀取狀態列中的文字**」撰寫進度列」。** 您也應該會看到進度列會更新每秒 20 秒。之後，會清除 [狀態] 列及進度列。

顯示動畫

狀態列會顯示迴圈的動畫，表示一長時間執行的作業（例如，建置方案中的多個專案）。如果看不到這個動畫，請確定您有正確工具 / 選項設定︰

移至工具/選項 / 一般索引標籤，然後取消核取自動調整根據用戶端效能的視覺效果。然後檢查子選項啟用豐富型用戶端視覺體驗。此外，您現在應該可以看到此動畫，當您建置您的 Visual Studio 的實驗性執行個體中的專案。

此程序中，我們會顯示標準的 Visual Studio 動畫代表建置專案或方案。