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.

Valor	Significado
CIF_SHOWHELP	A caixa de diálogo exibirá um botão Ajuda .
CIF_SELECTCURRENT	Na entrada, seleciona o botão de opção Atual na inicialização. Na saída, especifica que o usuário selecionou Atual.
CIF_SELECTDEFAULT	Na entrada, seleciona o botão de opção Padrão na inicialização. Na saída, especifica que o usuário selecionou Padrão.
CIF_SELECTFROMFILE	Na entrada, seleciona o botão de opção De Arquivo na inicialização. Na saída, especifica que o usuário selecionou De Arquivo.
CIF_USEICONEXE	Somente entrada. Extrai o ícone do executável especificado no membro szIconExe , em vez de recuperá-lo da classe . Isso é útil para a inserção ou vinculação OLE a arquivos não OLE.

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

Observação

O cabeçalho oledlg.h define OLEUICHANGEICON como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 Build 20348
Servidor mínimo com suporte	Windows 10 Build 20348
Cabeçalho	oledlg.h