Jump to content

WM PRESPARAMCHANGED

From EDM2
Revision as of 00:01, 14 April 2025 by Martini (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This message is sent when a presentation parameter is set or removed dynamically from a window instance using the WinSetPresParam or WinRemovePresParam functions. It is also sent to all windows owned by the window whose presentation parameter was changed.

Syntax

param1
    ULONG   idAttrType; /* Presentation parameter attribute identity. */

param2
    ULONG   ulReserved; /* Reserved value, should be 0. */
in Circular Slider Controls

This message is posted when a timer times out.

param1
     USHORT  idTimer     /*  Timer identity. */

param2
     ULONG   ulReserved  /*  Reserved value, should be 0. */
in Container Controls
param1
     ULONG  attrtype    /*  Presentation parameter attribute identity. */

param2
     ULONG  ulReserved  /*  Reserved value, should be 0. */
in Notebook Controls
param1
     ULONG  attrtype    /*  Attribute type. */

param2
     ULONG  ulReserved  /*  Reserved value, should be 0. */
in Slider Controls
param1
     ULONG  attrtype    /*  Attribute type. */

param2
     ULONG  ulReserved  /*  Reserved value, should be 0. */
in Value Set Controls
param1
     ULONG  attrtype    /*  Attribute type. */

param2
     ULONG  ulReserved  /*  Reserved value, should be 0. */

Parameters

idAttrType (ULONG) - input
Presentation parameter attribute identity.
ulReserved (ULONG) - input
Reserved value, should be 0.

in Circular Slider Controls

idTimer (USHORT) - input
Timer identity.
Any timer Ids that are not being used must be passed on the default window procedure.
ulReserved (ULONG) - input
Reserved value, should be 0.

in Container Controls

idAttrType (ULONG) - input
Presentation parameter attribute identity.
PP_BACKGROUNDCOLOR or PP_BACKGROUNDCOLORINDEX
Sets the background color of the container window. This color is initially set to SYSCLR_WINDOW.
PP_BORDERCOLOR or PP_BORDERCOLORINDEX
Sets the color of the title separators, column separators, and split bar. This color is initially set to SYSCLR_WINDOWFRAME.
PP_FONTNAMESIZE
Sets the font and font size of the text in the container. This font and font size defaults to the system font and font size.
PP_FOREGROUNDCOLOR or PP_FOREGROUNDCOLORINDEX
Sets the color of unselected text. This color is initially set to SYSCLR_WINDOWTEXT.
PP_HILITEBACKGROUNDCOLOR or PP_HILITEBACKGROUNDCOLORINDEX
Sets the color of selection emphasis, the color of the cursor of an unselected item in the details view, and the color of the cursor in all other views. This color is initially set to SYSCLR_HILITEBACKGROUND.
PP_HILITEFOREGROUNDCOLOR or PP_HILITEFOREGROUNDCOLORINDEX
Sets the color of the text of a selected item in all views and the color of the cursor of a selected item in the details view. This color is initially set to SYSCLR_HILITEFOREGROUND.
ulReserved (ULONG) - input
Reserved value, should be 0.


in Notebook Controls

attrtype (ULONG) - input
Attribute type. Presentation parameter attribute identity.
PP_BACKGROUNDCOLOR or PP_BACKGROUNDCOLORINDEX
Sets the background color of the notebook window. This color is initially set to SYSCLR_FIELDBACKGROUND.
PP_BORDERCOLOR or PP_BORDERCOLORINDEX
Sets the color of the notebook outline. This color is initially set to SYSCLR_WINDOWFRAME.
PP_FOREGROUNDCOLOR or PP_FOREGROUNDCOLORINDEX
Sets the color of text on the status line. This color is initially set to SYSCLR_WINDOWTEXT.
PP_HILITEBACKGROUNDCOLOR or PP_HILITEBACKGROUNDCOLORINDEX
Sets the color of the selection cursor. This color is initially set to SYSCLR_HILITEBACKGROUND.
ulReserved (ULONG) - input
Reserved value, should be 0.

in Slider Controls

attrtype (ULONG) - input
Attribute type. Presentation parameter attribute identity. The following presentation parameters are initialized by the slider control. The initial value of each is shown in the following list:
PP_FOREGROUNDCOLOR or PP_FOREGROUNDCOLORINDEX
Item foreground color; used when displaying text and bit maps. This color is initialized to SYSCLR_WINDOWTEXT.
PP_BACKGROUNDCOLOR or PP_BACKGROUNDCOLORINDEX
Slider background color; used for entire control as the background. This color is initialized to SYSCLR_WINDOW.
ulReserved (ULONG) - input
Reserved value, should be 0.

in Value Set Controls

attrtype (ULONG) - input
Attribute type. Presentation parameter attribute identity. The following presentation parameters are initialized by the value set control. The initial value of each is shown in the following list:
PP_FOREGROUNDCOLOR or PP_FOREGROUNDCOLORINDEX
Item foreground color; used when displaying text and bit maps. This color is initialized to SYSCLR_WINDOWTEXT.
PP_BACKGROUNDCOLOR or PP_BACKGROUNDCOLORINDEX
Value set background color; used for entire control as the background. This color is initialized to SYSCLR_WINDOW.
PP_HILITEBACKGROUNDCOLOR or PP_HILITEBACKGROUNDCOLORINDEX
Selection color; this is the color used for selected-state and target emphasis. This color is initialized to SYSCLR_HILITEBACKGROUND.
PP_BORDERCOLOR or PP_BORDERCOLORINDEX
Value set and item border color. This color is initialized to SYSCLR_WINDOWFRAME.
ulReserved (ULONG) - input
Reserved value, should be 0.

Returns

ulReserved (ULONG) - returns
Reserved value, should be 0.

Remarks

This message notifies a control when an inherited presentation parameter changes.

in Circular Slider Controls

This message is always queued and is processed specially by the WinGetMsg and WinPeekMsg calls, as follows:

  • Timers are processed only by the WinGetMsg and WinPeekMsg calls.
  • A timer posts only one WM_TIMER message at a time.
  • WM_TIMER messages are queued lower than all other messages except WM_SEM4 messages.

in Container Controls

The application uses the WinSetPresParam function to change presentation parameters. This results in a WM_PRESPARAMCHANGED (in Container Controls) message being sent to the container.

in Notebook Controls

The application uses this message to notify the notebook that a given inherited presentation parameter has changed.

in Slider Controls

The application uses this message to notify the slider that a given inherited presentation parameter has changed.

in Value Set Controls

The application uses this message to notify the value set that a given inherited presentation parameter has changed.

Default Processing

The default window procedure takes no action on this message, other than to set ulReserved to 0.