windows_programming_notes.nbk: Home | Index | Next Page: PBRANGE | Previous Page: PBM_SETSTEP

 PBM_STEPIT

Advances the current position for a progress bar by the step increment and redraws the bar to reflect the new position. An application sets the step increment by sending the PBM_SETSTEP message.

Syntax

To send this message, call the SendMessage function as follows.

    lResult = SendMessage(      // returns LRESULT in lResult
        (HWND) hWndControl,     // handle to destination control
        (UINT) PBM_STEPIT,      // message ID
        (WPARAM) wParam,        // = 0; not used, must be zero
        (LPARAM) lParam         // = 0; not used, must be zero
    );  

Parameters

• wParam
  Must be zero.
• lParam
  Must be zero.

Return Value

Returns the previous position.

Remarks

When the position exceeds the maximum range value, this message resets the current position so that the progress indicator starts over again from the beginning. = Message Information =

• Minimum DLL Version comctl32.dll version 4.00 or later
• Header commctrl.h
• Minimum operating systems Windows NT 4.0, Windows 95

windows_programming_notes.nbk: Home | Index | Next Page: PBRANGE | Previous Page: PBM_SETSTEP

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time