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

Récupère la hauteur du ruban.

Syntaxe

HRESULT GetHeight(
  [out] UINT32 *cy
);

Paramètres

[out] cy

Type : UINT32*

Hauteur du ruban, en pixels.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La valeur retournée pour cy est basée sur un certain nombre de dépendances qui incluent, sans s’y limiter, la largeur de la fenêtre hôte et le modèle de disposition déclaré dans le balisage du ruban.

Exemples

L’exemple suivant montre comment utiliser la méthode IUIRibbon ::GetHeight pour récupérer la hauteur du ruban afin de calculer l’emplacement d’affichage d’un contrôle contextuel .

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

Configuration requise

Voir aussi

IUIRibbon

Exemples d’infrastructure du ruban Windows