View source for CM QUERYRECORDEMPHASIS

This message queries for a container record with the specified emphasis attributes.
==Syntax==
<PRE>
param1
PRECORDCORE pSearchAfter; /* Pointer to the specified container record. */

param2
USHORT fEmphasisMask; /* Emphasis attribute. */
</PRE>
;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 (P[[RECORDCORE]]) - 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 (P[[RECORDCORE]]) - 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.

[[Category:Messages]]