Edit

MMC_TASK_DISPLAY_OBJECT structure (mmc.h)

  • Article

The MMC_TASK_DISPLAY_OBJECT structure is introduced in MMC 1.1.

The MMC_TASK_DISPLAY_OBJECT structure specifies the type of image and all the data required to use that image to display a task or the background on a taskpad.

For that which displays the task image, the MMC_TASK_DISPLAY_OBJECT structure is the sDisplayObject member of the MMC_TASK structure, which is filled in by the IEnumTASK::Next method.

For that which displays the background image, the MMC_TASK_DISPLAY_OBJECT structure is filled in by the IExtendTaskPad::GetBackground method.

Syntax

typedef struct _MMC_TASK_DISPLAY_OBJECT {
  MMC_TASK_DISPLAY_TYPE eDisplayType;
  union {
    MMC_TASK_DISPLAY_BITMAP uBitmap;
    MMC_TASK_DISPLAY_SYMBOL uSymbol;
  };
} MMC_TASK_DISPLAY_OBJECT;

Members

eDisplayType

Value of type MMC_TASK_DISPLAY_TYPE that specifies the type of image displayed as the background. The image can be one of three types: symbol, GIF, or bitmap.

uBitmap

MMC_TASK_DISPLAY_BITMAP structure that contains the resource paths to the image files of the image type specified by eDisplayType. MMC_TASK_DISPLAY_BITMAP contains the paths to the two images used when the user moves the mouse over a task and when the task is deselected.

The uBitmap member is used only if eDisplayType is one of the following values:

  • MMC_TASK_DISPLAY_TYPE_BITMAP
  • MMC_TASK_DISPLAY_TYPE_VANILLA_GIF
  • MMC_TASK_DISPLAY_TYPE_CHOCOLATE_GIF
The MMC_TASK_DISPLAY_TYPE_BITMAP value indicates that a non-transparent image is being used for the task or background. The MMC_TASK_DISPLAY_TYPE_VANILLA_GIF and MMC_TASK_DISPLAY_TYPE_CHOCOLATE_GIF values indicate that a transparent image is being used for the task or background.
Note  There is no difference between MMC_TASK_DISPLAY_TYPE_VANILLA_GIF and MMC_TASK_DISPLAY_TYPE_CHOCOLATE_GIF.
 

uSymbol

MMC_TASK_DISPLAY_SYMBOL structure that contains the font name, EOT (embedded OpenType) resource path, and characters to display as the image.

The uSymbol is used only if eDisplayType is MMC_TASK_DISPLAY_TYPE_SYMBOL.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Header mmc.h

See also

IEnumTASK::Next

IExtendTaskPad::GetBackground

MMC_TASK

MMC_TASK_DISPLAY_BITMAP

MMC_TASK_DISPLAY_SYMBOL

MMC_TASK_DISPLAY_TYPE