For single-selection containers, the selection of the previous container record is cancelled before another record is selected. The selection cursor is set with the CRA_CURSORED attribute for single-selection containers. Only one selection cursor is allowed.

The selection cursor must always be available to the user. Therefore, if you attempt to disable the selection cursor by specifying FALSE for the usChangeEmphasis parameter and CRA_CURSORED for the fEmphasisAttribute parameter, the PMERR_INVALID_PARAMETERS error is set. In order to change the selection cursor attribute, TRUE should be specified for the usChangeEmphasis parameter and CRA_CURSORED for the fEmphasisAttribute parameter. The pRecord parameter should point to the record to which the selection cursor should be applied. The container control removes the selection cursor from the record with the cursor and applies it to the new record.

A CN_EMPHASIS notification code is sent to the container owner if the record emphasis attribute is changed.


[Back] [Next]