Método IUIRibbon::GetHeight (uiribbon.h)
Recupera el alto de la cinta de opciones.
Sintaxis
HRESULT GetHeight(
[out] UINT32 *cy
);
Parámetros
[out] cy
Tipo: UINT32*
Alto de la cinta, en píxeles.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
El valor devuelto para cy se basa en una serie de dependencias que incluyen, entre otras, el ancho de la ventana host y la plantilla de diseño declarada en el marcado de la cinta de opciones.
Ejemplos
En el ejemplo siguiente se muestra cómo usar el método IUIRibbon::GetHeight para recuperar el alto de la cinta de opciones para calcular una ubicación para mostrar de un control Contextual Popup .
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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | uiribbon.h |
| Archivo DLL | Mshtml.dll |