Compartilhar via


Estrutura OLEUICONVERTW (oledlg.h)

Contém informações que a Biblioteca de Interface do Usuário OLE usa para inicializar a caixa de diálogo Converter e espaço para a biblioteca retornar informações quando a caixa de diálogo for descartada.

Sintaxe

typedef struct tagOLEUICONVERTW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPWSTR        lpszUserType;
  BOOL          fObjectsIconChanged;
  LPWSTR        lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;

Membros

cbStruct

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

dwFlags

Na entrada, esse campo 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
CF_SHOWHELPBUTTON
A caixa de diálogo exibirá um botão Ajuda. Esse sinalizador é definido na entrada.
CF_SETCONVERTDEFAULT
A classe cujo CLSID é especificado por clsidConvertDefault será usada como a seleção padrão. Essa seleção aparece na caixa de listagem de classes quando o botão de Converter para opção é selecionado. Esse sinalizador é definido na entrada.
CF_SETACTIVATEDEFAULT
A classe cujo CLSID é especificado por clsidActivateDefault será usada como a seleção padrão. Essa seleção aparece na caixa de listagem de classes quando o botão Ativar como opção é selecionado. Esse sinalizador é definido na entrada.
CF_SELECTCONVERTTO
Na entrada, esse sinalizador especifica que Converter em será inicialmente selecionado (comportamento padrão). Esse sinalizador será definido na saída se Converter para foi selecionado quando o usuário descartou a caixa de diálogo.
CF_SELECTACTIVATEAS
Na entrada, esse sinalizador especifica que Ativar como será inicialmente selecionado. Esse sinalizador será definido na saída se Ativar como foi selecionado quando o usuário descartou a caixa de diálogo.
CF_DISABLEDISPLAYASICON
O botão Ícone exibir como será desabilitado na inicialização.
CF_DISABLEACTIVATEAS
O botão de opção Ativar como será desabilitado na inicialização.
CF_HIDECHANGEICON
O botão Ícone de Alteração ficará oculto na caixa de diálogo Converter .
CF_CONVERTONLY
O botão de opção Ativar como será desabilitado na caixa de diálogo Converter .

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á Converter.

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 OLEUICONVERT 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 lpszTemplate. Esse membro será ignorado se o membro lpszTemplate for NULL ou inválido.

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 Converter da biblioteca.

hResource

Identificador de recurso para uma caixa de diálogo personalizada. Se esse membro for NULL, a biblioteca usará o modelo da caixa de diálogo Converter padrão ou, se for válido, o modelo nomeado pelo membro lpszTemplate.

clsid

O CLSID do objeto a ser convertido ou ativado. Esse membro é definido na entrada.

clsidConvertDefault

O CLSID a ser usado como a classe padrão quando Converter em é selecionado. Esse membro será ignorado se o membro dwFlags não incluir CF_SETCONVERTDEFAULT. Esse membro é definido na entrada.

clsidActivateDefault

O CLSID a ser usado como a classe padrão quando Ativar como é selecionado. Esse membro será ignorado se o membro dwFlags não incluir CF_SETACTIVATEDEFAULT. Esse membro é definido na entrada.

clsidNew

O CLSID da classe selecionada. Esse membro é definido na saída.

dvAspect

Aspecto do objeto. Isso deve ser DVASPECT_CONTENT ou DVASPECT_ICON. Se dvAspect estiver DVASPECT_ICON na entrada, a caixa Ícone exibir como será marcada e o ícone do objeto será exibido. Esse membro é definido na entrada e na saída. Para obter mais informações, consulte DVASPECT.

wFormat

Formato de dados do objeto a ser convertido ou ativado.

fIsLinkedObject

VERDADEIRO se o objeto estiver vinculado. Esse membro é definido na entrada.

hMetaPict

O METAFILEPICT que contém o aspecto icônico. Esse membro é definido na entrada e na saída.

lpszUserType

Ponteiro para o nome tipo de usuário do objeto a ser convertido ou ativado. Se esse valor for NULL, a caixa de diálogo recuperará o nome de Tipo de Usuário do Registro. Essa cadeia de caracteres é liberada na saída.

fObjectsIconChanged

VERDADEIRO se o ícone do objeto foi alterado. (ou seja, se OleUIChangeIcon foi chamado e não cancelado.). Esse membro é definido na saída.

lpszDefLabel

Ponteiro para o rótulo padrão a ser usado para o ícone. Se NULL, o nome de tipo de usuário curto será usado. Se o objeto for um link, o chamador deverá passar o nome de exibição da origem do link. Isso é liberado na saída.

cClsidExclude

Número de CLSIDs no lpClsidExclude.

lpClsidExclude

Ponteiro para a lista de CLSIDs a serem excluídos da lista.

Observações

Nota

O cabeçalho oledlg.h define OLEUICONVERT 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 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho oledlg.h

Consulte também

OleUIChangeIcon

OleUIConvert