L_ContainerSetOwnerDraw

#include "LtCon.h"

L_LTCON_API L_INT L_ContainerSetOwnerDraw(pContainer, fOwnerDraw, dwFlags)

pCONTAINERHANDLE pContainer;

/* pointer to a container handle */

L_BOOL fOwnerDraw;

/* owner-draw enable/disable flag */

L_UINT32 dwFlags;

/* reserved */

Sets the container to owner draw mode.

Parameter

Description

pContainer

Pointer to a container handle.

fOwnerDraw

Flag that indicates whether to enable or disable the container owner draw mode. Possible values are:

 

Value

Meaning

 

TRUE

Enable owner draw mode.

 

FALSE

Disable owner draw mode.

dwFlags

Reserved for future use. Must be 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

When the owner draw mode is enabled the container will not draw the object path any more. The user will be responsible for all the drawing issues.

When the owner draw mode is disabled, the drawing of objects is handled automatically. If the owner draw mode is enabled, the user must handle all aspects of drawing objects.

Required DLLs and Libraries

LTCON

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_ContainerIsOwnerDraw

Topics:

Getting and Setting Container Properties

Example

This example toggles the owner draw mode of the container.

 L_INT ContainerSetOwnerDrawExample(pCONTAINERHANDLE pContainer)
{
   L_INT nRet;
   L_BOOL fOwnerDraw ;
   /* Get the owner draw mode of the container */
   nRet = L_ContainerIsOwnerDraw( pContainer, &fOwnerDraw ) ;
   if(nRet != SUCCESS)
      return nRet;
   /* Toggle the state and return */
   return L_ContainerSetOwnerDraw( pContainer,!fOwnerDraw, 0 ) ;
   
}