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 descartada.

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. Na saída, 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 selecionado Atual.
CIF_SELECTDEFAULT	Na entrada, seleciona o botão de opção Padrão na inicialização. Ao sair, especifica que o usuário selecionado Padrão.
CIF_SELECTFROMFILE	Na entrada, seleciona o botão de opção Do Arquivo na inicialização. Na saída, especifica que o usuário selecionou do 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 NULL, a biblioteca usará Í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 de gancho 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 de 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 da caixa de diálogo que deve ser substituído pelo modelo da 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 metafile.

clsid

Somente entrada. A classe a ser usada para obter o ícone de 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 seja incluído no membro dwFlags e uma tentativa de recuperar o ícone de classe do CLSID especificado falhará.

cchIconExe

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

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10 Build 20348
servidor com suporte mínimo	Windows 10 Build 20348
cabeçalho	oledlg.h