estrutura MMC_TASK_DISPLAY_BITMAP (mmc.h)
A estrutura MMC_TASK_DISPLAY_BITMAP é introduzida no MMC 1.1.
A estrutura MMC_TASK_DISPLAY_BITMAP é usada para o membro uBitmap da estrutura MMC_TASK_DISPLAY_OBJECT especificar todos os dados necessários para exibir uma imagem GIF ou bitmap para uma tarefa ou plano de fundo em um bloco de tarefas.
Sintaxe
typedef struct _MMC_TASK_DISPLAY_BITMAP {
LPOLESTR szMouseOverBitmap;
LPOLESTR szMouseOffBitmap;
} MMC_TASK_DISPLAY_BITMAP;
Membros
szMouseOverBitmap
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho do recurso para o arquivo de imagem da imagem exibida para a tarefa quando o usuário move o mouse sobre a imagem ou área de texto da tarefa.
A cadeia de caracteres deve ter o seguinte formato:
"res:// filepath/imgpath"
em que filepath é o caminho completo para a DLL do snap-in que armazena o arquivo de imagem como um recurso, e imgpath é o caminho do recurso do arquivo de imagem com a DLL de snap-in.
Por exemplo, a cadeia de caracteres a seguir especifica que a DLL de snap-in (snapin.dll) tem um caminho de "c:\windows\system32\snapin.dll" e que o caminho do recurso é img/mon.gif: "res://c:\windows\system32\snapin.dll/img/mon.bmp".
Se szMouseOverBitmap apontar para uma cadeia de caracteres NULL , szMouseOffBitmap deverá ser uma cadeia de caracteres válida que contenha o local de uma imagem válida. Se uma dessas cadeias de caracteres for NULL, a outra cadeia de caracteres será usada para ambas. Se ambos os locais de imagem do mouse forem NULL, a tarefa não será exibida.
szMouseOffBitmap
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho do recurso para o arquivo de imagem da imagem exibida para a tarefa quando o mouse não está na imagem ou área de texto da tarefa.
Consulte szMouseOverBitmap para obter o formato da cadeia de caracteres.
Se szMouseOffBitmap apontar para uma cadeia de caracteres NULL , szMouseOverBitmap deverá ser uma cadeia de caracteres válida que contenha o local de uma imagem válida. Se uma dessas cadeias de caracteres for NULL, a outra cadeia de caracteres será usada para ambas. Se ambos os locais de imagem do mouse forem NULL, a tarefa não será exibida.
Comentários
Aloque as cadeias de caracteres szMouseOverBitmap e szMouseOffBitmap usadas na estrutura com a função de API COM CoTaskMemAlloc (ou o equivalente) e o MMC as liberará.
Se szMouseOverBitmap e szMouseOffBitmap apontarem para uma cadeia de caracteres NULL , a tarefa não aparecerá no bloco de tarefas. Se uma dessas cadeias de caracteres for NULL, a outra cadeia de caracteres será usada para ambas.
Requisitos
Cliente mínimo com suporte | Windows Vista |
Servidor mínimo com suporte | Windows Server 2008 |
Cabeçalho | mmc.h |