CProgressCtrl::SetBarColor

發行項
02/28/2013

設定進度列顯示的色彩在目前進度列控制項。

COLORREF SetBarColor(
         COLORREF clrBar
);

參數

參數	描述
[in] clrBar	指定進度列顯示的新色彩的 COLORREF 值。指定 CLR_DEFAULT 導致進度列使用其預設色彩。

傳回值

進度列顯示的上一個色彩，表示為 COLORREF 值或 CLR_DEFAULT ，如果進度列顯示的色彩為預設色彩。

備註

只有在 Windows Vista佈景主題實際上，不是 SetBarColor 方法設定進度列色彩。

這個方法會將 PBM_SETBARCOLOR 資訊，在 Windows SDK說明。

範例

下列程式碼範例會定義變數， m_progressCtrl，用來以程式設計方式存取進度列控制項。這個變數用於下一個範例。

    // Variable to access the progress control
    CProgressCtrl m_progressCtrl;

下列程式碼範例會變更進度列的色彩變更為紅色，綠色，藍色或預設值。

// Set the progress bar color to red, green, blue, or 
// the system default. The SetBarColor method has an 
// effect only if the Windows system theme is Classic.
void CCProgressCtrl_s1Dlg::OnSetbarcolorRed()
{
    m_progressCtrl.SetBarColor(RGB(255,0,0));
}

void CCProgressCtrl_s1Dlg::OnSetbarcolorGreen()
{
    m_progressCtrl.SetBarColor(RGB(0,255,0));
}

void CCProgressCtrl_s1Dlg::OnSetbarcolorBlue()
{
    m_progressCtrl.SetBarColor(RGB(0,0,255));
}

void CCProgressCtrl_s1Dlg::OnSetbarcolorOri()
{
    m_progressCtrl.SetBarColor(CLR_DEFAULT);
}