CM QUERYRECORDEMPHASIS

This message queries for a container record with the specified emphasis attributes.

Syntax

param1
PRECORDCORE pSearchAfter; /* Pointer to the specified container record. */

param2
USHORT fEmphasisMask; /* Emphasis attribute. */

Note

; If the CCS_MINIRECORDCORE style bit is specified when a container is created, then MINIRECORDCORE should be used instead of RECORDCORE, and PMINIRECORDCORE should be used instead of PRECORDCORE in all applicable data structures and messages.

Parameters

pSearchAfter (PRECORDCORE) - Input

Pointer to the specified container record. The values of this parameter can be:

CMA_FIRST: Start the search with the first record in the container.

Other: Start the search after the record specified by this pointer.

fEmphasisMask (USHORT) - Input

Emphasis attribute. Specifies the emphasis attribute of the container record. The following states can be combined using a logical OR operator (|):

CRA_COLLAPSED: Specifies that a record is collapsed.

CRA_CURSORED: Specifies that a record will be drawn with a selection cursor.

CRA_DISABLED: Specifies that a record will be drawn with unavailable-state emphasis.

CRA_DROPONABLE: Specifies that a record can be a target for direct manipulation.

CRA_EXPANDED: Specifies that a record is expanded.

CRA_FILTERED: Specifies that a record is filtered and, therefore, hidden from view.

CRA_INUSE: Specifies that a record will be drawn with in-use emphasis.

CRA_PICKED: Specifies that the container record will be picked up as part of the drag set.

CRA_SELECTED: Specifies that a record will be drawn with selected-state emphasis.

CRA_SOURCE: Specifies that a record will be drawn with source-menu emphasis.

Returns

pRecord (PRECORDCORE) - returns

Pointer to the record with the specified emphasis.

NULL: This implies that none of the records that follow the pointer specified in the pSearchAfter parameter meet those specifications.

-1: The container record data was not returned. The WinGetLastError function may return the following error:

PMERR_INVALID_PARAMETERS (1208)

Other: Pointer to a container record with the specified emphasis. This is the first record that follows the record pointed to by the pSearchAfter parameter and satisfies the criteria specified in the fEmphasisMask parameter. To find the next record that satisfies this criteria, send this message again, but this time use the value returned in the pRecord parameter for the value of the pSearchAfter parameter.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it other than to return NULL.