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
標頭	uiribbon.h
Dll	Mshtml.dll

另請參閱

IUIRibbon

Windows 功能區架構範例