Jump to content

wpSetNextIconPos

From EDM2
Revision as of 02:02, 17 November 2025 by Martini (talk | contribs) (Created page with "{{DISPLAYTITLE:wpSetNextIconPos}} This instance method is called to allow the folder to change the next icon position. ==Syntax== _wpSetNextIconPos(somSelf, pptl) ==Parameters== ;''somSelf'' (WPFolder *) - input :Pointer to the object on which the method is being invoked. :Points to an object of class WPFolder. ;''pptl'' (PPOINTL) - input :Position within the folder. ==Returns== ;''rc'' (BOOL) - returns :Success indicator. :'''TRUE''' Successful comp...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This instance method is called to allow the folder to change the next icon position.

Syntax

_wpSetNextIconPos(somSelf, pptl)

Parameters

somSelf (WPFolder *) - input
Pointer to the object on which the method is being invoked.
Points to an object of class WPFolder.
pptl (PPOINTL) - input
Position within the folder.

Returns

rc (BOOL) - returns
Success indicator.
TRUE Successful completion.
FALSE Error occurred.

How to Override

This method is generally not overridden.

Usage

This method can be called at any time in order to set the next icon position at which objects will be inserted into the folder. If this method is used, the previous next position should be queried and restored afterwards.

Remarks

The next icon position is typically set during a drag or drop operation in order to ensure that the items dropped into a folder are located where the user wanted them.

Example Code

#define INCL_WINWORKPLACE
#include <os2.h>

WPFolder *somSelf; /* Pointer to the object on which the method is being invoked. */
PPOINTL *pptl; /* Position within the folder. */
BOOL rc; /* Success indicator. */

rc = _wpSetNextIconPos(somSelf, pptl);

Related Methods