DrgVerifyRMF
This function determines if a given rendering mechanism and format are supported for a dragged object.
Syntax
DrgVerifyRMF(pDragitem, pMech, pFormat)
Parameters
- pDragitem (PDRAGITEM) - input
- Pointer to the DRAGITEM structure whose native rendering mechanism and format are to be validated.
- pMech (PSZ) - input
- String specifying the rendering mechanism to search for. NULL will match any mechanism.
- pFormat (PSZ) - input
- String specifying the rendering format to search for. NULL will match any format.
Returns
- rc (BOOL) - returns
- Validity indicator.
- TRUE - Successful completion.
- FALSE - Error occurred.
Remarks
This function determines if a given rendering mechanism and format ordered pair are represented in the set of valid pairs specified by hstrRMF for the dragged object.
Example Code
This example determines if a given rendering mechanism and format are supported for a dragged object.
#define INCL_WINSTDDRAG /* Direct Manipulation (Drag) Functions */
#include <OS2.H>
DRAGITEM Dragitem; /* DRAGITEM structure whose native */
/* rendering mechanism and format are */
/* to be validated */
char pszMech[] = "DRM_OS2FILE"; /* A string specifying the rendering */
/* mechanism to search for */
char pszFormat[] = "DRF_TEXT"; /* A string specifying the rendering */
/* format to search for */
if(DrgVerifyRMF(&Dragitem, pszMech, pszFormat))
/* Mechanism is an OS/2 file and format */
/* is a null-terminated string */
{
/* Code block */
}