Método IUIRibbon::GetHeight (uiribbon.h)

Recupera a altura da faixa de opções.

Sintaxe

HRESULT GetHeight(
  [out] UINT32 *cy
);

Parâmetros

[out] cy

Tipo: UINT32*

A altura da faixa de opções, em pixels.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O valor retornado para cy baseia-se em várias dependências que incluem, mas não se limitam a, a largura da janela do host e o modelo de layout declarado na marcação faixa de opções.

Exemplos

O exemplo a seguir demonstra como usar o método IUIRibbon::GetHeight para recuperar a altura da faixa de opções para calcular um local de exibição para um controle pop-up de contexto .

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;
    }
  }
}

Requisitos

Confira também

IUIRibbon

Exemplos da Estrutura da Faixa de Opções do Windows