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 o 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.
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á Converter.
lpfnHook
Ponteiro para uma função de gancho que processa mensagens destinadas à caixa de diálogo. A função hook 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 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 de caixa de diálogo que deve ser substituído pelo modelo de 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 de caixa de diálogo Converter padrão ou, se for válido, o modelo chamado 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 para é 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 está 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 for DVASPECT_ICON na entrada, a caixa Exibir como Ícone 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
TRUE 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 tipo de usuário do registro. Essa cadeia de caracteres é liberada na saída.
fObjectsIconChanged
TRUE se o ícone do objeto foi alterado. (ou seja, se OleUIChangeIcon foi chamado e não foi 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 em lpClsidExclude.
lpClsidExclude
Ponteiro para a lista de CLSIDs a serem excluídos da lista.
Comentários
Observação
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 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 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | oledlg.h |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de