Função OleUIConvertA (oledlg.h)
Invoca a caixa de diálogo Converter padrão, permitindo que o usuário altere o tipo de um único objeto especificado ou o tipo de todos os objetos OLE da classe do objeto especificado.
Sintaxe
UINT OleUIConvertA(
[in] LPOLEUICONVERTA unnamedParam1
);
Parâmetros
[in] unnamedParam1
Ponteiro para uma estrutura OLEUICONVERT que contém informações usadas para inicializar a caixa de diálogo.
Retornar valor
Definições padrão de êxito/erro
Código de retorno | Descrição |
---|---|
|
Falha desconhecida (não utilizado). |
|
O usuário pressionou o botão OK. |
|
Nenhum erro, o mesmo que OLEUI_OK. |
|
O usuário pressionou o botão Cancelar. |
Erros de validação de campo padrão
Código de retorno | Descrição |
---|---|
|
Erros comuns a todas as caixas de diálogo estão no intervalo OLEUI_ERR_STANDARDMIN a OLEUI_ERR_STANDARDMAX. Esse valor permite que o aplicativo teste mensagens padrão para exibir mensagens de erro para o usuário. |
|
O ponteiro para uma estrutura OLEUIXXX passada para a função era NULL. |
|
Permissões insuficientes para acesso de leitura ou gravação a uma estrutura OLEUIXXX. |
|
O valor de cbstruct está incorreto. |
|
O valor hWndOwner é inválido. |
|
O valor lpszCaption é inválido. |
|
O valor lpfnHook é inválido. |
|
O valor hInstance é inválido. |
|
O valor lpszTemplate é inválido. |
|
O valor hResource é inválido. |
Erros de inicialização
Código de retorno | Descrição |
---|---|
|
Não é possível localizar o modelo da caixa de diálogo. |
|
Não é possível carregar o modelo da caixa de diálogo. |
|
Falha na inicialização da caixa de diálogo. |
|
Uma chamada para LocalAlloc ou o alocador IMalloc padrão falhou. |
|
Uma chamada para GlobalAlloc ou o alocador IMalloc padrão falhou. |
|
Não é possível chamar LoadString para recursos localizados da biblioteca. |
|
Falha ao chamar o alocador IMalloc padrão. |
Erros específicos da função
Código de retorno | Descrição |
---|---|
|
Erros comuns a todas as caixas de diálogo estão no intervalo OLEUI_ERR_STANDARDMIN a OLEUI_ERR_STANDARDMAX. Esse valor permite que o aplicativo teste mensagens padrão para exibir mensagens de erro para o usuário. |
|
Um valor clsid era inválido. |
|
O valor dvAspect era inválido. Esse membro especifica o aspecto do objeto . |
|
O valor wFormat era inválido. Esse membro especifica o formato de dados do objeto . |
|
Um valor de cadeia de caracteres (por exemplo, lpszUserType ou lpszDefLabel) era inválido. |
Comentários
OleUIConvert preenche a caixa de listagem da caixa de diálogo Converter com classes de objeto atravessando o registro e procurando entradas nas teclas Readable e ReadWritable. Cada classe que inclui o formato de arquivo padrão da classe original em sua chave legível é adicionada à lista Converter e cada classe que inclui o formato de arquivo padrão da classe original em sua chave ReadWritable é adicionada à lista Ativar como. A lista Converter é mostrada na caixa de listagem da caixa de diálogo quando o botão de opção Converter é selecionado (a seleção padrão) e a lista Ativar como é mostrada quando Ativar como está selecionado.
Observe que você pode alterar o tipo de todos os objetos de uma determinada classe somente quando CF_CONVERTONLY não for especificado.
O comando convert, que invoca essa função, só deverá ser disponibilizado para o usuário se OleUICanConvertOrActivateAs retornar S_OK.
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] |
Plataforma de Destino | Windows |
Cabeçalho | oledlg.h |
Biblioteca | OleDlg.lib |
DLL | OleDlg.dll |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
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, consulteEnviar e exibir comentários de