Estrutura SCROLLINFO (winuser.h)

  • Artigo

A estrutura SCROLLINFO contém parâmetros de barra de rolagem a serem definidos pela função SetScrollInfo (ou SBM_SETSCROLLINFO mensagem) ou recuperados pela função GetScrollInfo (ou SBM_GETSCROLLINFO mensagem).

Sintaxe

typedef struct tagSCROLLINFO {
  UINT cbSize;
  UINT fMask;
  int  nMin;
  int  nMax;
  UINT nPage;
  int  nPos;
  int  nTrackPos;
} SCROLLINFO, *LPSCROLLINFO;

Membros

cbSize

Tipo: UINT

Especifica o tamanho, em bytes, dessa estrutura. O chamador deve definir isso como sizeof (SCROLLINFO).

fMask

Tipo: UINT

Especifica os parâmetros da barra de rolagem a serem definidos ou recuperados. Esse membro pode ser uma combinação dos seguintes valores:

Valor Significado
SIF_ALL
 Combinação de SIF_PAGE, SIF_POS, SIF_RANGE e SIF_TRACKPOS.
SIF_DISABLENOSCROLL
 Esse valor é usado somente ao definir os parâmetros de uma barra de rolagem. Se os novos parâmetros da barra de rolagem tornarem a barra de rolagem desnecessária, desabilite a barra de rolagem em vez de removê-la.
SIF_PAGE
 O membro nPage contém o tamanho da página de uma barra de rolagem proporcional.
SIF_POS
 O membro nPos contém a posição da caixa de rolagem, que não é atualizada enquanto o usuário arrasta a caixa de rolagem.
SIF_RANGE
 Os membros nMin e nMax contêm os valores mínimo e máximo para o intervalo de rolagem.
SIF_TRACKPOS
 O membro nTrackPos contém a posição atual da caixa de rolagem enquanto o usuário a arrasta.

nMin

Tipo: int

Especifica a posição mínima de rolagem.

nMax

Tipo: int

Especifica a posição máxima de rolagem.

nPage

Tipo: UINT

Especifica o tamanho da página, em unidades de dispositivo. Uma barra de rolagem usa esse valor para determinar o tamanho apropriado da caixa de rolagem proporcional.

nPos

Tipo: int

Especifica a posição da caixa de rolagem.

nTrackPos

Tipo: int

Especifica a posição imediata de uma caixa de rolagem que o usuário está arrastando. Um aplicativo pode recuperar esse valor durante o processamento do código de solicitação SB_THUMBTRACK. Um aplicativo não pode definir a posição de rolagem imediata; a função SetScrollInfo ignora esse membro.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winuser.h (inclua Windows.h)

Confira também

Getscrollinfo

Referência

SBM_GETSCROLLINFO

SBM_SETSCROLLINFO

Setscrollinfo