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

Weitere Informationen

IUIRibbon

Windows-Menübandframeworkbeispiele