Estrutura NONCLIENTMETRICSA (winuser.h)
Contém as métricas escalonáveis associadas à área nãocliente de uma janela não minimizada. Essa estrutura é usada pelas ações SPI_GETNONCLIENTMETRICS e SPI_SETNONCLIENTMETRICS da função SystemParametersInfo .
Sintaxe
typedef struct tagNONCLIENTMETRICSA {
UINT cbSize;
int iBorderWidth;
int iScrollWidth;
int iScrollHeight;
int iCaptionWidth;
int iCaptionHeight;
LOGFONTA lfCaptionFont;
int iSmCaptionWidth;
int iSmCaptionHeight;
LOGFONTA lfSmCaptionFont;
int iMenuWidth;
int iMenuHeight;
LOGFONTA lfMenuFont;
LOGFONTA lfStatusFont;
LOGFONTA lfMessageFont;
int iPaddedBorderWidth;
} NONCLIENTMETRICSA, *PNONCLIENTMETRICSA, *LPNONCLIENTMETRICSA;
Membros
cbSize
O tamanho da estrutura em bytes. O chamador deve definir isso como sizeof(NONCLIENTMETRICS). Para obter informações sobre a compatibilidade do aplicativo, consulte Comentários.
iBorderWidth
A espessura da borda de dimensionamento, em pixels. O padrão é 1 pixel.
iScrollWidth
A largura de uma barra de rolagem vertical padrão, em pixels.
iScrollHeight
A altura de uma barra de rolagem horizontal padrão, em pixels.
iCaptionWidth
A largura dos botões legenda, em pixels.
iCaptionHeight
A altura dos botões legenda, em pixels.
lfCaptionFont
Uma estrutura LOGFONT que contém informações sobre a fonte legenda.
iSmCaptionWidth
A largura de botões pequenos legenda, em pixels.
iSmCaptionHeight
A altura de legendas pequenas, em pixels.
lfSmCaptionFont
Uma estrutura LOGFONT que contém informações sobre a fonte de legenda pequena.
iMenuWidth
A largura dos botões da barra de menus, em pixels.
iMenuHeight
A altura de uma barra de menus, em pixels.
lfMenuFont
Uma estrutura LOGFONT que contém informações sobre a fonte usada nas barras de menu.
lfStatusFont
Uma estrutura LOGFONT que contém informações sobre a fonte usada em status barras e dicas de ferramentas.
lfMessageFont
Uma estrutura LOGFONT que contém informações sobre a fonte usada em caixas de mensagem.
iPaddedBorderWidth
A espessura da borda acolchoda, em pixels. O valor padrão é 4 pixels. Os membros iPaddedBorderWidth e iBorderWidth são combinados para janelas redimensionáveis e não consideráveis na experiência da área de trabalho do Windows Aero. Para compilar um aplicativo que usa esse membro, defina _WIN32_WINNT como 0x0600 ou posterior. Para obter mais informações, consulte Comentários.
Windows Server 2003 e Windows XP/2000: Não há suporte para esse membro.
Comentários
Se o membro iPaddedBorderWidth da estrutura NONCLIENTMETRICS estiver presente, essa estrutura será 4 bytes maior do que para um aplicativo compilado com _WIN32_WINNT menor ou igual a 0x0502. Para obter mais informações sobre a compilação condicional, consulte Usando os cabeçalhos do Windows.
Windows Server 2003 e Windows XP/2000: Se um aplicativo compilado para Windows Server 2008 ou Windows Vista também precisar ser executado no Windows Server 2003 ou Windows XP/2000, use a função GetVersionEx para marcar a versão do sistema operacional em tempo de execução e, se o aplicativo estiver em execução no Windows Server 2003 ou Windows XP/2000, subtraia o tamanho do membro iPaddedBorderWidth do membro cbSize da estrutura NONCLIENTMETRICS antes de chamar o Função SystemParametersInfo.
Observação
O cabeçalho winuser.h define NONCLIENTMETRICS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | winuser.h (inclua Windows.h) |