На главную

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 | Скачать Вниз

SetScrollPos



The SetScrollPos function sets the position of the scroll box (thumb) in the specified scroll bar and, if requested, redraws the scroll bar to reflect the new position of the scroll box. The SetScrollPos function is provided for compatibility with Windows 3.x. Win32-based applications should use the SetScrollInfo function.

int SetScrollPos(

HWND hWnd, // handle of window with scroll bar
int nBar, // scroll bar flag
int nPos, // new position of scroll box
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 position of the scroll box in a scroll bar control. The hWnd parameter must be the handle of the scroll bar control.
SB_HORZ Sets the position of the scroll box in a window's standard horizontal scroll bar.
SB_VERT Sets the position of the scroll box in a window's standard vertical scroll bar.


nPos

Specifies the new position of the scroll box. The position must be within the scrolling range. For more information about the scrolling range, see the SetScrollRange function.

bRedraw

Specifies whether the scroll bar is redrawn to reflect the new scroll box position. 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 the previous position of the scroll box.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

If the scroll bar is redrawn by a subsequent call to another function, setting the bRedraw parameter to FALSE is useful.
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 SetScrollPos function's nPos 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, ScrollDC, ScrollWindow, SetScrollRange


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

SetScrollPos



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

int SetScrollPos(

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


Параметры

hWnd

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

nBar

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

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


nPos

Определяет что новая позиция перемещает ящик. Позиция должна быть в пределах прокрутки дипазона. Более подробно о прокрутке дипазона, смотри функцию SetScrollRange.

bRedraw

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



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

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

Замечания

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

Смотри Также

GetScrollPos, GetScrollRange, ScrollDC, ScrollWindow, SetScrollRange


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