Função OleUIInsertObjectW (oledlg.h)
Invoca a caixa de diálogo Inserir Objeto padrão, que permite que o usuário selecione um nome de origem e classe de objeto, bem como a opção de exibir o objeto como ele mesmo ou como um ícone.
Sintaxe
UINT OleUIInsertObjectW(
[in] LPOLEUIINSERTOBJECTW unnamedParam1
);
Parâmetros
[in] unnamedParam1
Ponteiro para a estrutura de
Valor de retorno
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 foi NULL. |
|
Permissões insuficientes para acesso de leitura ou gravação a uma estrutura OLEUIXXX. |
|
O valor de de cbstruct |
|
O valor hWndOwner |
|
O valor lpszCaption |
|
O valor |
|
O valor de hInstance |
|
O valor lpszTemplate é inválido. |
|
O hResource valor é 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. |
|
Falha ao |
|
Falha ao |
|
Não é possível chamar LoadString para recursos localizados da biblioteca. |
|
Falha ao chamar o alocador de IMalloc de |
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. |
|
O valor lpszFile é inválido ou o usuário tem permissões de acesso de gravação insuficientes. Esse membro lpszFile aponta para o nome do arquivo vinculado ou inserido. |
|
O valor ppvOjb |
|
O valor lpIOleClientSite |
|
O valor lpIStorage |
|
O sc membro do lpIO tem informações de erro adicionais. |
|
O valor lpClsidExclude |
|
O cchFile |
Observações
OleUIInsertObject permite que o usuário selecione o tipo de objeto a ser inserido em uma caixa de listagem que contém os aplicativos de objeto registrados no sistema do usuário. Para preencher essa caixa de listagem, OleUIInsertObject percorre o registro, adicionando todos os servidores de objetos encontrados que atendem aos seguintes critérios:
- A entrada do Registro não inclui a chave NotInsertable.
- A entrada do Registro inclui um protocolo de estilo OLE 1.0\\StdFileEditing\\Server key.
- A entrada do Registro inclui a chave inserivel.
- O CLSID do objeto não está incluído na lista de objetos a serem excluídos (o lpClsidExclude membro do OLEUIINSERTOBJECT).
Para liberar um HMETAFILEPICT retornado da caixa de diálogo Inserir Objeto ou Colar Especial, exclua o metafile anexado no identificador, da seguinte maneira:
void FreeHmetafilepict(HMETAFILEPICT hmfp)
{
if (hmfp != NULL)
{
LPMETAFILEPICT pmfp = GlobalLock(hmfp);
DeleteMetaFile(pmfp->hMF);
GlobalUnlock(hmfp);
GlobalFree(hmfp);
}
else
{
// Handle null pointers here.
exit(0);
}
}
Nota
O cabeçalho oledlg.h define OLEUIINSERTOBJECT 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 |