Função OleUIConvertA (oledlg.h)

Artigo
11/20/2024

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.

Valor de retorno

Definições padrão de êxito/erro

Código de retorno	Descrição
OLEUI_FALSE	Falha desconhecida (não utilizado).
OLEUI_OK	O usuário pressionou o botão OK.
OLEUI_SUCCESS	Nenhum erro, o mesmo que OLEUI_OK.
OLEUI_CANCEL	O usuário pressionou o botão Cancelar.

Erros de validação de campo padrão

Código de retorno	Descrição
OLEUI_ERR_STANDARDMIN	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.
OLEUI_ERR_STRUCTURENULL	O ponteiro para uma estrutura OLEUIXXX passada para a função foi NULL.
OLEUI_ERR_STRUCTUREINVALID	Permissões insuficientes para acesso de leitura ou gravação a uma estrutura OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT	O valor de de cbstruct está incorreto.
OLEUI_ERR_HWNDOWNERINVALID	O valor hWndOwner é inválido.
OLEUI_ERR_LPSZCAPTIONINVALID	O valor lpszCaption é inválido.
OLEUI_ERR_LPFNHOOKINVALID	O valor lpfnHook é inválido.
OLEUI_ERR_HINSTANCEINVALID	O valor de hInstance é inválido.
OLEUI_ERR_LPSZTEMPLATEINVALID	O valor lpszTemplate é inválido.
OLEUI_ERR_HRESOURCEINVALID	O hResource valor é inválido.

Erros de inicialização

Código de retorno	Descrição
OLEUI_ERR_FINDTEMPLATEFAILURE	Não é possível localizar o modelo da caixa de diálogo.
OLEUI_ERR_LOADTEMPLATEFAILURE	Não é possível carregar o modelo da caixa de diálogo.
OLEUI_ERR_DIALOGFAILURE	Falha na inicialização da caixa de diálogo.
OLEUI_ERR_LOCALMEMALLOC	Falha ao LocalAlloc ou ao alocador de IMalloc de padrão.
OLEUI_ERR_GLOBALMEMALLOC	Falha ao GlobalAlloc ou ao alocador de IMalloc de padrão.
OLEUI_ERR_LOADSTRING	Não é possível chamar LoadString para recursos localizados da biblioteca.
OLEUI_ERR_OLEMEMALLOC	Falha ao chamar o alocador de IMalloc de padrão.

Erros específicos da função

Código de retorno	Descrição
OLEUI_ERR_STANDARDMAX	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.
OLEUI_CTERR_CLASSIDINVALID	Um valor clsid era inválido.
OLEUI_CTERR_DVASPECTINVALID	O valor dvAspect era inválido. Este membro especifica o aspecto do objeto.
OLEUI_CTERR_CBFORMATINVALID	O valor wFormat era inválido. Esse membro especifica o formato de dados do objeto.
OLEUI_CTERR_STRINGINVALID	Um valor de cadeia de caracteres (por exemplo, lpszUserType ou lpszDefLabel) era inválido.

Observações

OleUIConvert popula a caixa de listagem da caixa de diálogo Converter com classes de objeto percorrendo o registro e procurando entradas nas chaves Legíveis e Legíveis. Cada classe que inclui o formato de arquivo padrão da classe original em sua chave legível é adicionada à lista Converter e todas as classes que incluem o formato de arquivo padrão da classe original em sua chave ReadWritable são adicionadas à lista Ativar como. A lista Converter é mostrada na caixa de listagem da caixa de diálogo quando o botão de Converter opção é 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 ao usuário se OleUICanConvertOrActivateAs retornar S_OK.

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]
da Plataforma de Destino	Windows
cabeçalho	oledlg.h
biblioteca	OleDlg.lib
de DLL	OleDlg.dll

Consulte também

OLEUICONVERT

OleUICanConvertOrActivateAs

Compartilhar via