CHeaderCtrl::GetItemDropDownRect
Возвращает ограничивающий прямоугольник разворачивающуюся кнопку элемента заголовка в текущем элементе управления заголовка.
BOOL GetItemDropDownRect(
int iItem,
LPRECT lpRect
) const;
Параметры
Параметр |
Описание |
|---|---|
[входящий] iItem |
Индекс, начинающийся с нуля элемента, для которого HDF_SPLITBUTTON стиль заголовка.Дополнительные сведения см. в разделе fmt члена структуры HDITEM. |
[исходящий] lpRect |
Указатель на структуру RECT для получения сведений о ограничивающего прямоугольника. |
Возвращаемое значение
true если эта функция успешно; в противном случае – значение false.
Заметки
Этот метод отправляет сообщение HDM_GETITEMDROPDOWNRECT, которое описано в Windows SDK.
Требования
заголовок: afxcmn.h
Этот метод поддерживается в Windows Vista и более поздних версиях.
Дополнительные требования для этого метода см. в Требования построения для элементов управления Windows Vista общих.
Пример
В следующем примере кода определяется переменной m_headerCtrl, которая используется для доступа к текущий элемент управления заголовка.Эта переменная используется в следующем примере.
CHeaderCtrl m_headerCtrl;
CSplitButton m_splitButton;
В следующем примере кода демонстрируется применение метода GetItemDropDownRect.В предыдущем разделе кода, мы создали элемент управления заголовка с 5 столбцами.В следующем примере кода рисует прямоугольник 3-d вокруг расположения в первом столбце, зарезервированные для разворачивающейся кнопки заголовка.
void CNVC_MFC_CHeaderCtrl_s4Dlg::OnXGetitemdropdownrect()
{
if (controlCreated == FALSE) {
MessageBox(_T("Header control has not been created yet."));
return;
}
// Get the dropdown rect for the first column.
CRect rect;
BOOL bRetVal = m_headerCtrl.GetItemDropDownRect(0, &rect);
if (bRetVal == TRUE) {
// Draw around the dropdown rect a rectangle that has red
// left and top sides, and blue right and bottom sides.
CDC* pDC = m_headerCtrl.GetDC();
pDC->Draw3dRect(rect, RGB(255, 0, 0), RGB(0, 0, 255));
}
}