Estrutura NONCLIENTMETRICSA (winuser.h)

Contém as métricas escalonáveis associadas à área nãocliente de uma janela não gerenciada. 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 de legenda, em pixels.

iCaptionHeight

A altura dos botões de legenda, em pixels.

lfCaptionFont

Uma estrutura LOGFONT que contém informações sobre a fonte de legenda.

iSmCaptionWidth

A largura dos botões de legenda pequena, em pixels.

iSmCaptionHeight

A altura de legendas pequenas, em pixels.

lfSmCaptionFont

Uma estrutura de 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 de LOGFONT que contém informações sobre a fonte usada nas barras de menus.

lfStatusFont

Uma estrutura LOGFONT que contém informações sobre a fonte usada em barras de status 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: Este membro não tem suporte.

Observações

Se o iPaddedBorderWidth membro 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 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 verificar 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 do cbSize membro da estrutura NONCLIENTMETRICS antes de chamar a função SystemParametersInfo.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	winuser.h (inclua Windows.h)

Consulte também

DO LOGFONT

SystemParametersInfo