estrutura MMC_LISTPAD_INFO (mmc.h)
A estrutura MMC_LISTPAD_INFO é introduzida no MMC 1.1.
A estrutura MMC_LISTPAD_INFO é preenchida pelo método IExtendTaskPad::GetListPadInfo para especificar as seguintes informações para um bloco de tarefas de exibição de lista:
- Texto do título para o controle de lista
- Texto para um botão opcional
- A ID de comando passada para IExtendTaskPad::TaskNotify quando esse botão é clicado.
Sintaxe
typedef struct _MMC_LISTPAD_INFO {
LPOLESTR szTitle;
LPOLESTR szButtonText;
LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;
Membros
szTitle
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto colocado diretamente acima do controle de lista. Esse texto pode ser o rótulo dos objetos dentro do controle de lista (como "Impressoras" se a lista contiver impressoras) ou instruções (como "Selecionar uma impressora e clicar em uma ação para executar").
Se szTitle for NULL ou vazio, nenhum título será exibido para o controle de lista.
Lembre-se de que o membro szTitle não é o mesmo que o parâmetro pszTitle para IExtendTaskPad::GetTitle. O método IExtendTaskPad::GetTitle retorna o título de todo o bloco de tarefas que aparece na parte superior do bloco de tarefas e aparece em cada bloco de tarefas padrão do MMC. O membro szTitle do MMC_LISTPAD_INFO é o rótulo do controle de lista e aparece apenas em blocos de tarefas de exibição de lista do MMC.
szButtonText
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto colocado em um botão que está diretamente acima do controle de lista e à direita do texto szTitle .
Quando o usuário clica nesse botão no bloco de tarefas, o MMC chama o método IExtendTaskPad::TaskNotify do snap-in e passa o valor especificado em nCommandID como uma estrutura VARIANT no parâmetro arg. O VARIANT passado para TaskNotify tem um membro vt definido como VT_I4 e um membro lVal que contém a ID do comando.
Para fazer com que o botão apareça sem texto, defina szButtonText como uma cadeia de caracteres vazia.
Para ocultar esse botão para aparecer no bloco de tarefas, defina szButtonText como NULL.
nCommandID
Valor que serve como um identificador para o botão especificado por szButtonText. É recomendável tornar esse valor exclusivo para cada bloco de tarefas para ajudar a identificar o bloco de tarefas que enviou a notificação de clique com botão.
Quando o usuário clica nesse botão, o MMC chama o método IExtendTaskPad::TaskNotify do snap-in e passa esse valor como uma VARIANT no parâmetro arg.
Esse valor será ignorado se szButtonText for NULL.
Comentários
Aloque as cadeias de caracteres szTitle e szButtonText com a função de API COM CoTaskMemAlloc (ou o equivalente) e o MMC o lançará.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Cabeçalho | mmc.h |