Compartilhar via


CDN_INCLUDEITEM código de notificação

[A partir do Windows Vista, as caixas de diálogo abrir e salvar como comuns foram substituídas pela caixa de diálogo Item Comum. Recomendamos que você use a API de Caixa de Diálogo de Item Comum em vez dessas caixas de diálogo da Biblioteca de Caixas de Diálogo Comuns.]

Enviada por uma caixa de diálogo Abrir ou Salvar como para determinar se a caixa de diálogo deve exibir um item na lista de itens de uma pasta de shell. Quando o usuário abre uma pasta, a caixa de diálogo envia uma notificação de CDN_INCLUDEITEM para cada item na pasta. A caixa de diálogo envia essa notificação somente se o sinalizador OFN_ENABLEINCLUDENOTIFY foi definido quando a caixa de diálogo foi criada.

Seu procedimento de gancho OFNHookProc recebe essa mensagem na forma de uma mensagem WM_NOTIFY .

#define CDN_FIRST               (0U-601U)
#define CDN_INCLUDEITEM         (CDN_FIRST - 0x0007)

Parâmetros

wParam

Este parâmetro não é usado.

lParam

Um ponteiro para uma estrutura OFNOTIFYEX .

A estrutura OFNOTIFYEX contém uma estrutura NMHDR cujo membro de código indica a mensagem de notificação CDN_INCLUDEITEM.

O membro psf da estrutura OFNOTIFYEX é um ponteiro para uma interface para a pasta cujos itens estão sendo enumerados. O membro pidl é um ponteiro para uma lista de identificadores de item que identifica o item relativo à pasta.

Valor retornado

Se o procedimento de gancho OFNHookProc retornar zero, a caixa de diálogo excluirá o item da lista de itens.

Para incluir o item, retorne um valor diferente de zero do procedimento de gancho.

Comentários

A caixa de diálogo sempre inclui itens que têm os atributos SFGAO_FILESYSTEM e SFGAO_FILESYSANCESTOR , independentemente do valor retornado por CDN_INCLUDEITEM.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Commdlg.h (inclua Windows.h)

Confira também

Referência

Getopenfilename

Getsavefilename

OFNHookProc

OFNOTIFYEX

Conceitual

Biblioteca de caixas de diálogo comuns