Metodo IUIRibbon::GetHeight (uiribbon.h)

Articolo
03/03/2024

Recupera l'altezza della barra multifunzione.

Sintassi

HRESULT GetHeight(
  [out] UINT32 *cy
);

Parametri

[out] cy

Tipo: UINT32*

Altezza della barra multifunzione, in pixel.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il valore restituito per cy si basa su una serie di dipendenze che includono, ma non solo, la larghezza della finestra host e il modello di layout dichiarato nel markup della barra multifunzione.

Esempio

Nell'esempio seguente viene illustrato come utilizzare il metodo IUIRibbon::GetHeight per recuperare l'altezza della barra multifunzione per calcolare una posizione di visualizzazione per un controllo Popup di contesto .

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiribbon.h
DLL	Mshtml.dll

Vedi anche

IUIRibbon

Esempi di Windows Ribbon Framework

Condividi tramite