Estrutura OLEUICHANGEICONW (oledlg.h)

Contém informações que a Biblioteca de Interface do Usuário OLE usa para inicializar a caixa de diálogo Ícone de Alteração e contém espaço para a biblioteca retornar informações quando a caixa de diálogo for ignorada.

Sintaxe

typedef struct tagOLEUICHANGEICONW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  WCHAR         szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONW, *POLEUICHANGEICONW, *LPOLEUICHANGEICONW;

Membros

cbStruct

O tamanho da estrutura em bytes. Esse campo deve ser preenchido na entrada.

dwFlags

Na entrada, especifica os sinalizadores de inicialização e criação. Ao sair, ele especifica as opções do usuário. Pode ser uma combinação dos sinalizadores a seguir.

hWndOwner

A janela que possui a caixa de diálogo. Esse membro não deve ser NULL.

lpszCaption

Ponteiro para uma cadeia de caracteres a ser usada como o título da caixa de diálogo. Se FOR NULL, a biblioteca usará o Ícone de Alteração.

lpfnHook

Ponteiro para uma função de gancho que processa mensagens destinadas à caixa de diálogo. A função de gancho deve retornar zero para passar uma mensagem informando que ela não foi processada novamente para o procedimento da caixa de diálogo na biblioteca. A função hook deve retornar um valor diferente de zero para impedir que o procedimento da caixa de diálogo da biblioteca processe uma mensagem que já foi processada.

lCustData

Dados definidos pelo aplicativo que a biblioteca passa para a função de gancho apontada pelo membro lpfnHook . A biblioteca passa um ponteiro para a estrutura OLEUICHANGEICON no parâmetro lParam da mensagem WM_INITDIALOG; esse ponteiro pode ser usado para recuperar o membro lCustData .

hInstance

Instância que contém um modelo de caixa de diálogo especificado pelo membro lpTemplateName .

lpszTemplate

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do arquivo de recurso para o modelo de caixa de diálogo que deve ser substituído pelo modelo de caixa de diálogo Ícone de Alteração da biblioteca.

hResource

Identificador de modelo personalizado.

hMetaPict

Imagem atual e final. A origem do ícone é inserida no próprio metarquivo.

clsid

Somente entrada. A classe a ser usada para obter o ícone Padrão .

szIconExe[MAX_PATH]

Somente entrada. Ponteiro para o executável do qual extrair o ícone padrão. Esse membro é ignorado, a menos que CIF_USEICONEXE esteja incluído no membro dwFlags e uma tentativa de recuperar o ícone de classe do CLSID especificado falhe.

cchIconExe

Somente entrada. O número de caracteres em szIconExe. Esse membro é ignorado, a menos que CIF_USEICONEXE seja incluído no membro dwFlags .

Comentários

Requisitos