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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | uiribbon.h |
| DLL | Mshtml.dll |