CM_QUERYRECORDEMPHASIS - Parameters

pSearchAfter (PRECORDCORE)

Pointer to the specified container record.

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.

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)

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.

pRecord (PRECORDCORE)

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.

---

[Back: CM_QUERYRECORDEMPHASIS Return Value - pRecord]
[Next: CM_QUERYRECORDEMPHASIS - Syntax]