Метод IUIRibbon::GetHeight (uiribbon.h)
Возвращает высоту ленты.
Синтаксис
HRESULT GetHeight(
[out] UINT32 *cy
);
Параметры
[out] cy
Тип: UINT32*
Высота ленты в пикселях.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Значение, возвращаемое для cy , основано на ряде зависимостей, которые включают, помимо прочего, ширину главного окна и шаблон макета, объявленный в разметке ленты.
Примеры
В следующем примере показано, как использовать метод IUIRibbon::GetHeight для получения высоты ленты для вычисления расположения отображения элемента управления Контекстное всплывающее окно.
void GetDisplayLocation(POINT &pt, HWND hWnd)
{
if (pt.x == -1 && pt.y == -1)
{
HRESULT hr = E_FAIL;
// Display the menu in the upper-left corner of the client area, below the ribbon.
IUIRibbon* pRibbon;
hr = g_pFramework->GetView(0, IID_PPV_ARGS(&pRibbon));
if (SUCCEEDED(hr))
{
UINT32 uRibbonHeight = 0;
hr = pRibbon->GetHeight(&uRibbonHeight);
if (SUCCEEDED(hr))
{
pt.x = 0;
pt.y = uRibbonHeight;
// Convert client coordinates of a specified point to screen coordinates.
ClientToScreen(hWnd, &pt);
}
pRibbon->Release();
}
if (FAILED(hr))
{
// Default to just the upper-right corner of the entire screen.
pt.x = 0;
pt.y = 0;
}
}
}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | uiribbon.h |
| DLL | Mshtml.dll |