DDGPE::SetMode (Windows Embedded CE 6.0)
1/6/2010
This method changes the current display mode and conditionally update the current GDI surface. You must implement the GPE version of this method. You should also override DDGPE's version of the method to allow it to operate properly.
Syntax
virtual SCODE SetMode(
int modeNo,
HPALETTE* pPalette,
BOOL bChangeGDISurfaceMode
);
Parameters
- modeNo
Requested mode number.
- pPalette
Palette for the requested mode, if applicable. If the palette does not apply, or if the default palette should be used, this parameter should be NULL.
- bChangeGDISurfaceMode
Indicates whether the GDI surface mode should be changed as a result of the SetMode. If this parameter is TRUE, the current GDI mode is modified,and the GDI surface is reallocated, if necessary. Otherwise, this method only sets the hardware's mode and updates the physical mode settings.
Return Value
None.
Remarks
The DDGPE::SetMode method is similar to the GPE::SetMode method. The difference between them is the addition of the bChangeGDISurfaceMode parameter for DDGPE. If this parameter is TRUE, the behavior of SetMode should be identical to that expected of the GPE version. If the parameter is FALSE, the SetMode method should just change the physical mode. In both cases, the m_dwPhysicalModeID DDGPE member variable should be updated.
Requirements
| Header | ddgpe.h |
| Library | Ddgpe.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |