Estrutura NONCLIENTMETRICSW (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 tagNONCLIENTMETRICSW {
  UINT     cbSize;
  int      iBorderWidth;
  int      iScrollWidth;
  int      iScrollHeight;
  int      iCaptionWidth;
  int      iCaptionHeight;
  LOGFONTW lfCaptionFont;
  int      iSmCaptionWidth;
  int      iSmCaptionHeight;
  LOGFONTW lfSmCaptionFont;
  int      iMenuWidth;
  int      iMenuHeight;
  LOGFONTW lfMenuFont;
  LOGFONTW lfStatusFont;
  LOGFONTW lfMessageFont;
  int      iPaddedBorderWidth;
} NONCLIENTMETRICSW, *PNONCLIENTMETRICSW, *LPNONCLIENTMETRICSW;

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)

Confira também

LOGFONT

SystemParametersInfo