WinChangeSwitchEntry

From EDM2
Jump to: navigation, search

Modifies the specified entry in the task list.

Syntax

WinChangeSwitchEntry(switchHndl, switchControlStruct)

Parameters

switchHndl - HSWITCH - input 
The task list switch handle.
switchControlStruct - SWCNTRL - input 
Switch control data.

Returns

ULONG with values of:

Zero 
success
Non-zero 
unsuccessful

WinGetLastError could return:

Define (C/C++)

INCL_WINSWITCHLIST or INCL_WIN or INCL_PM

Calling Convention

Cdecl32

Example Code

HSWITCH switchHndl;
SWCNTRL switchControlStruct; 
ULONG   rc;
...
rc = WinChangeSwitchEntry(switchHndl, switchControlStruct);
...

Related Functions

Notes

If the standard window was created with FCF_TASKLIST it is not necessary to call WinChangeSwitchEntry; WinSetWindowText, on its handle, changes the title bar and task list text.

If you want to change a few fields, not many, it is advisable to initialize the switch control structure via WinQuerySwitchEntry. Then modify those fields and call WinChangeSwitchEntry for the update.