December 21, 2024

Dynamic Windows Function [dw_container_query_start]

Syntax

char * dw_container_query_start(HWND handle, unsigned long flags)

Parameters

HWND handle: Handle to the window (widget) to be queried.
unsigned long flags: If this parameter is DW_CRA_SELECTED it will only return items that are currently selected. Otherwise it will return all records in the container.

Returns

char * Pointer to data associated with first entry or NULL on error.

Description

Starts a new query of a container.

Remarks

As of version 3.0 this function returns a duplicated buffer with the title which needs to be freed with dw_free() unless the DW_CR_RETDATA flag is passed, which causes it to instead return the data pointer.