Função OleUIPasteSpecialA (oledlg.h)
Invoca a caixa de diálogo Colar Especial padrão, permitindo que o usuário selecione o formato do objeto da área de transferência a ser colado ou vinculado à colagem.
Sintaxe
UINT OleUIPasteSpecialA(
[in] LPOLEUIPASTESPECIALA unnamedParam1
);
Parâmetros
[in] unnamedParam1
Um ponteiro para uma estrutura de OLEUIPASTESPECIAL
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 obter 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 |
|
O |
|
O |
|
O conteúdo da área de transferência foi alterado enquanto a caixa de diálogo era exibida. |
|
O membro lpSrcDataObj |
Observações
O design da caixa de diálogo Colar Especial pressupõe que, se você estiver disposto a permitir que um usuário vincule a um objeto, você também está disposto a permitir que o usuário insira esse objeto. Por esse motivo, se qualquer um dos sinalizadores de OLEUIPASTE_LINKTYPE associados à enumeração OLEUIPASTEFLAG
O texto exibido no campo
Para liberar uma
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 OLEUIPASTESPECIAL 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
OLEUIPASTEFLAG