CHeaderCtrl::GetOverflowRect
取得目前標題控制項溢位按鈕的週框 (Bounding Rectangle)。
BOOL GetOverflowRect(
LPRECT lpRect
) const;
參數
參數 |
描述 |
|---|---|
[out] lpRect |
要取得週框 (Bounding Rectangle) 的資訊 的長度 結構的指標。 |
傳回值
true ，如果此函式成功，否則， false。
備註
如果標題控制項能夠同時顯示包含更多項目，控制項可以顯示溢位按鈕該捲動至不可見的項目。 標題控制項必須顯示 HDS_OVERFLOW 和 HDF_SPLITBUTTON 的樣式溢位按鈕。 只有在溢位按鈕顯示時，週框住溢位按鈕而存在。 如需詳細資訊，請參閱 Header Control Styles。
這個方法會將 HDM_GETOVERFLOWRECT 資訊，在 Windows SDK說明。
需求
標題: afxcmn.h
這個控制項在 Windows Vista (含) 以後版本支援。
這個方法的其他需要。 組建的 Windows Vista 通用控制項的需求說明。
範例
下列程式碼範例會定義變數， m_headerCtrl，用於存取目前標題控制項。 這個變數用於下一個範例。
CHeaderCtrl m_headerCtrl;
CSplitButton m_splitButton;
下列程式碼範例將示範 GetOverflowRect 方法。 在程式碼中更早的章節中，我們會使用五個資料行的標題控制項。 不過，您可以拖曳資料行分隔符號，讓資料行並不是可見的。 如果某些資料行不可見，標題控制項繪製溢位按鈕。 下列程式碼範例會在溢位按鈕的位置周圍繪製 3D 矩形。
void CNVC_MFC_CHeaderCtrl_s4Dlg::OnXGetoverflowrect()
{
if (controlCreated == FALSE) {
MessageBox(_T("Header control has not been created yet."));
return;
}
CRect rect;
// Get the overflow rectangle.
BOOL bRetVal = m_headerCtrl.GetOverflowRect(&rect);
// Get the device context.
CDC* pDC = m_headerCtrl.GetDC();
// Draw around the overflow rect a rectangle that has red
// left and top sides, and green right and bottom sides.
pDC->Draw3dRect(rect, RGB(255, 0, 0), RGB(0, 255, 0));
}