windows_programming_notes.nbk: Home | Index | Next Page: PBM_GETRANGE | Previous Page: PAINTSTRUCT

 PBM_DELTAPOS

Advances the current position of a progress bar by a specified increment and redraws the bar to reflect the new position.

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_DELTAPOS,    // message ID
        (WPARAM) wParam,        // = (WPARAM) (int) nIncrement;
        (LPARAM) lParam         // = 0; not used, must be zero
    ); 

Parameters

• nIncrement
  Amount to advance the position.
• lParam
  Must be zero.

Return Value

Returns the previous position.

Remarks

If the increment results in a value outside the range of the control, the position is set to the nearest boundary.

The behavior of this message is undefined if it is sent to a control that has the PBS_MARQUEE style.

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: PBM_GETRANGE | Previous Page: PAINTSTRUCT

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