Função SetScrollInfo (winuser.h)

A função SetScrollInfo define os parâmetros de uma barra de rolagem, incluindo as posições de rolagem mínima e máxima, o tamanho da página e a posição da caixa de rolagem (polegar). A função também redesenhará a barra de rolagem, se solicitado.

Sintaxe

int SetScrollInfo(
  [in] HWND          hwnd,
  [in] int           nBar,
  [in] LPCSCROLLINFO lpsi,
  [in] BOOL          redraw
);

Parâmetros

[in] hwnd

Tipo: HWND

Manipule para um controle de barra de rolagem ou uma janela com uma barra de rolagem padrão, dependendo do valor do parâmetro fnBar .

[in] nBar

Tipo: int

Especifica o tipo de barra de rolagem para a qual definir parâmetros. Esse parâmetro pode usar um dos valores a seguir.

[in] lpsi

Tipo: LPCSCROLLINFO

Ponteiro para uma estrutura SCROLLINFO . Antes de chamar SetScrollInfo, defina o membro cbSize da estrutura como sizeof(SCROLLINFO), defina o membro fMask para indicar os parâmetros a serem definidos e especifique os novos valores de parâmetro nos membros apropriados.

O membro fMask pode ser um ou mais dos valores a seguir.

[in] redraw

Tipo: BOOL

Especifica se a barra de rolagem é redesenhada para refletir as alterações na barra de rolagem. Se esse parâmetro for TRUE, a barra de rolagem será redesenhada; caso contrário, ela não será redesenhada.

Valor retornado

Tipo: int

O valor retornado é a posição atual da caixa de rolagem.

Comentários

A função SetScrollInfo executa a verificação de intervalo nos valores especificados pelos membros nPage e nPos da estrutura SCROLLINFO . O membro nPage deve especificar um valor de 0 a nMax - nMin +1. O membro nPos deve especificar um valor entre nMin e nMax - max( nPage– 1, 0). Se um dos valores estiver além de seu intervalo, a função o definirá como um valor que está apenas dentro do intervalo.

Se o parâmetro fnBar for SB_CTL e a janela especificada pelo parâmetro hwnd não for um controle de barra de rolagem do sistema, o sistema enviará a mensagem SBM_SETSCROLLINFO para a janela para definir informações da barra de rolagem (o sistema poderá otimizar a mensagem para SBM_SETPOS ou SBM_SETRANGE se a solicitação for exclusivamente para a posição ou intervalo). Isso permite que SetScrollInfo opere em um controle personalizado que imita uma barra de rolagem. Se a janela não manipular SBM_SETSCROLLINFO (ou a mensagem de SBM_SETPOS otimizada ou SBM_SETRANGE mensagem), a função SetScrollInfo falhará.

Para obter um exemplo, consulte Rolando texto com a mensagem WM_PAINT.

Requisitos

Confira também

Getscrollinfo

Referência

SCROLLINFO