IUIRibbon::GetHeight-Methode (uiribbon.h)
Ruft die Höhe des Menübands ab.
Syntax
HRESULT GetHeight(
[out] UINT32 *cy
);
Parameter
[out] cy
Typ: UINT32*
Die Höhe des Menübands in Pixel.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Der für cy zurückgegebene Wert basiert auf einer Reihe von Abhängigkeiten, die die Breite des Hostfensters und die im Menüband-Markup deklarierte Layoutvorlage umfassen, aber nicht darauf beschränkt sind.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die IUIRibbon::GetHeight-Methode verwendet wird, um die Höhe des Menübands abzurufen, um eine Anzeigeposition für ein Kontext-Popup-Steuerelement zu berechnen.
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;
}
}
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | uiribbon.h |
| DLL | Mshtml.dll |