На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

SetScrollRange



The SetScrollRange function sets the minimum and maximum position values for the specified scroll bar. It can also be used to hide or show a standard scroll bar.The SetScrollRange function is provided for compatibility with Windows 3.x. Win32-based applications should use the SetScrollInfo function.

BOOL SetScrollRange(

HWND hWnd, // handle of window with scroll bar
int nBar, // scroll bar flag
int nMinPos, // minimum scrolling position
int nMaxPos, // maximum scrolling position
BOOL bRedraw // redraw flag
);


Parameters

hWnd

Identifies a scroll bar control or a window with a standard scroll bar, depending on the value of the nBar parameter.

nBar

Specifies the scroll bar to be set. This parameter can be one of the following values:

Value Meaning
SB_CTL Sets the range of a scroll bar control. The hWnd parameter must be the handle of the scroll bar control.
SB_HORZ Sets the range of a window's standard horizontal scroll bar.
SB_VERT Sets the range of a window's standard vertical scroll bar.


nMinPos

Specifies the minimum scrolling position.

nMaxPos

Specifies the maximum scrolling position.

bRedraw

Specifies whether the scroll bar should be redrawn to reflect the change. If this parameter is TRUE, the scroll bar is redrawn. If it is FALSE, the scroll bar is not redrawn.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

An application should not call the SetScrollRange function to hide a scroll bar while processing a scroll bar message.
If the call to SetScrollRange immediately follows a call to the SetScrollPos function, the bRedraw parameter in SetScrollPos must be zero to prevent the scroll bar from being drawn twice.
The default range for a standard scroll bar is 0 through 100. The default range for a scroll bar control is empty (both the nMinPos and nMaxPos parameter values are zero). The difference between the values specified by the nMinPos and nMaxPos parameters must not be greater than the value of MAXLONG.

Because the messages that indicate scroll bar position, WM_HSCROLL and WM_VSCROLL, are limited to 16 bits of position data, applications that rely solely on those messages for position data have a practical maximum value of 65,535 for the SetScrollRange function's nMaxPos parameter.
However, because the SetScrollPos, SetScrollRange, GetScrollPos, and GetScrollRange functions support 32-bit scroll bar position data, there is a way to circumvent the 16-bit barrier of the WM_HSCROLL and WM_VSCROLL messages. See GetScrollPos for a description of the technique and its limits.

See Also

GetScrollPos, GetScrollRange, SetScrollPos


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SetScrollRange



Функция SetScrollRange устанавливает минимальный и максимальные величины позиции для определенного перемещают бар. Это может также использовано, чтобы прятать или показывать что стандарт перемещает бар.Функция SetScrollRange предусмотрена для совместимости Окном 3.x. базирующиеся приложения Win32 должны использовать функцию SetScrollInfo.

BOOL SetScrollRange(

HWND hWnd, // РУЧКА окна с перемещать бар int nBar, // перемещать флаг бара int nMinPos, // минимум, перемещающий позицию int nMaxPos, // максимум, перемещающий обновление изображения флага позиции BOOL bRedraw //
);


Параметры

hWnd

Идентифицирует перемещать управление бара или окно со стандартом перемещать бар, в зависимости от величины параметра nBar.

nBar

Определяет перемещать бар, чтобы быть установленн. Этот параметр может быть одним из следующего величин:

Значение Величины
SB_CTL Устанавливается, дипазон перемещает управление бара. Параметр hWnd должен быть ручкой перемещать управление бара.
SB_HORZ Устанавливается, дипазон окна стандартный горизонтальный перемещает бар.
SB_VERT Устанавливается, дипазон окна стандартный вертикальный перемещает бар.


nMinPos

Определяет минимум, перемещающий позицию.

nMaxPos

Определяет максимум, перемещающий позицию.

bRedraw

Определяет независимо перемещать бар должно быть redrawn, чтобы отражать изменение. Если этот параметр является ИСТИНОЙ, перемещать бар - redrawn. Если это - ЛОЖЬ, перемещать бар - не redrawn.



Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Приложение не должно вызывать функцию SetScrollRange, чтобы прятать перемещать зону при обработке перемещать сообщение зоны.
Если вызов на SetScrollRange немедленно следует за вызовом в функцию SetScrollPos, параметру bRedraw в SetScrollPos должно быть нулем, чтобы предохранять перемещать зону из сделанным дважды.
По умолчанию дипазон для стандарта перемещает зону - 0 по 100. По умолчанию дипазон для перемещает зону, управление пустое (как nMinPos так и величины параметра nMaxPos являются нулем). Различие между величинами определялось nMinPos и параметры nMaxPos не должны быть больше, чем величина MAXLONG.

Поскольку сообщения, которые указывают перемещать позицию зоны, WM_HSCROLL и WM_VSCROLL, ограниченные 16 битами данных позиции, приложений, которые доверяются исключительно в тех сообщениях для данных позиции иметь практическую максимальную величину 65,535 для SetScrollRange функционального параметра nMaxPos.
Тем не менее, поскольку SetScrollPos, SetScrollRange, GetScrollPos, и 32- бит поддержки функций GetScrollRange перемещает данные позиции зоны, есть путь обходить 16- битовый барьер WM_HSCROLL и сообщений WM_VSCROLL. Смотри GetScrollPos для описания техники и пределов.

Смотри Также

GetScrollPos, GetScrollRange, SetScrollPos


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz