Estrutura OLEUIPASTESPECIALA (oledlg.h)

Contém informações que a Biblioteca de Interface do Usuário OLE usa para inicializar a caixa de diálogo Colar Especial , bem como o espaço para a biblioteca retornar informações quando a caixa de diálogo for ignorada.

Sintaxe

typedef struct tagOLEUIPASTESPECIALA {
  DWORD              cbStruct;
  DWORD              dwFlags;
  HWND               hWndOwner;
  LPCSTR             lpszCaption;
  LPFNOLEUIHOOK      lpfnHook;
  LPARAM             lCustData;
  HINSTANCE          hInstance;
  LPCSTR             lpszTemplate;
  HRSRC              hResource;
  LPDATAOBJECT       lpSrcDataObj;
  LPOLEUIPASTEENTRYA arrPasteEntries;
  int                cPasteEntries;
  UINT               *arrLinkTypes;
  int                cLinkTypes;
  UINT               cClsidExclude;
  LPCLSID            lpClsidExclude;
  int                nSelectedIndex;
  BOOL               fLink;
  HGLOBAL            hMetaPict;
  SIZEL              sizel;
} OLEUIPASTESPECIALA, *POLEUIPASTESPECIALA, *LPOLEUIPASTESPECIALA;

Membros

cbStruct

O tamanho da estrutura em bytes. Esse membro deve ser preenchido na entrada.

dwFlags

Na entrada, dwFlags especifica os sinalizadores de inicialização e criação. Ao sair, ele especifica as opções do usuário. Pode ser uma combinação dos sinalizadores a seguir.

Valor Significado
PSF_SHOWHELP
A caixa de diálogo exibirá um botão Ajuda .
PSF_SELECTPASTE
O botão de opção Colar será selecionado na inicialização da caixa de diálogo. Esse será o padrão, se PSF_SELECTPASTE ou PSF_SELECTPASTELINK não forem especificados. Além disso, ele especifica o estado do botão na terminação da caixa de diálogo. Sinalizador IN/OUT.
PSF_SELECTPASTELINK
O botão de opção ColarLink será selecionado na inicialização da caixa de diálogo. Além disso, especifica o estado do botão na terminação da caixa de diálogo. Sinalizador IN/OUT.
PSF_CHECKDISPLAYASICON
Se o botão de opção Exibir como Ícone foi marcado na terminação da caixa de diálogo. Sinalizador OUT.
PSF_DISABLEDISPLAYASICON
A caixa marcar Ícone Exibir como será desabilitada na inicialização.
HIDECHANGEICON
Usado para desabilitar o botão alterar ícone na caixa de diálogo, que está disponível para os usuários quando eles estão colando um objeto OLE por padrão. Consulte STAYONCLIPBOARDCHANGE caso contrário.
STAYONCLIPBOARDCHANGE
Usado para dizer à caixa de diálogo para ficar em dia se a área de transferência for alterada enquanto a caixa de diálogo estiver ativa. Se o usuário alternar para outro aplicativo e copiar ou cortar algo, a caixa de diálogo, por padrão, executará uma operação de cancelamento, que removerá a caixa de diálogo, pois as opções que ela está no meio da apresentação ao usuário não estão mais atualizadas em relação ao que realmente está na área de transferência.
NOREFRESHDATAOBJECT
Usado em conjunto com STAYONCLIPBOARDCHANGE (ele não faz nada de outra forma). Se a área de transferência for alterada enquanto a caixa de diálogo estiver ativa e STAYONCLIPBOARDCHANGE for especificada, NOREFRESHDATAOBJECT indicará que a caixa de diálogo NÃO deve atualizar o conteúdo da caixa de diálogo para refletir o novo conteúdo da área de transferência. Isso será útil se o aplicativo estiver usando a caixa de diálogo colar especial em um IDataObject além do da área de transferência, por exemplo, como parte de uma operação de arrastar e soltar com o botão direito do mouse.

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á Colar Especial.

lpfnHook

Ponteiro para uma função de gancho que processa mensagens destinadas à caixa de diálogo. A função de gancho 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 OLEUIPASTESPECIAL 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 lpTemplateName .

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 Colar Especial da biblioteca.

hResource

Identificador de modelo personalizado.

lpSrcDataObj

Ponteiro para a interface IDataObject do objeto de dados a ser colado (da área de transferência). Esse membro é preenchido na entrada. Se lpSrcDataObj for NULL quando OleUIPasteSpecial for chamado, OleUIPasteSpecial tentará recuperar um ponteiro para um IDataObject da área de transferência. Se OleUIPasteSpecial for bem-sucedido, é responsabilidade do chamador liberar o IDataObject retornado em lpSrcDataObj.

arrPasteEntries

A matriz OLEUIPASTEENTRY que especifica formatos aceitáveis. Esse membro é preenchido na entrada.

cPasteEntries

Número de entradas de matriz OLEUIPASTEENTRY . Esse membro é preenchido na entrada.

arrLinkTypes

Lista de tipos de link aceitáveis. Os tipos de link são referenciados usando OLEUIPASTEFLAG em arrPasteEntries. Esse membro é preenchido na entrada.

cLinkTypes

Número de tipos de link. Esse membro é preenchido na entrada.

cClsidExclude

Número de CLSIDs em lpClsidExclude. Esse membro é preenchido na entrada.

lpClsidExclude

Ponteiro para uma matriz de CLSIDs a serem excluídos da lista de objetos de servidor disponíveis para uma operação Colar. Observe que isso não afeta Colar Link. Um aplicativo pode impedir a inserção em si mesmo listando seu próprio CLSID nesta lista. Esse campo é preenchido na entrada.

nSelectedIndex

Índice de arrPasteEntries que o usuário selecionou. Esse membro é preenchido na saída.

fLink

Se Colar ou Colar Link foi selecionado pelo usuário. Esse membro é preenchido na saída.

hMetaPict

Manipule para o Metarquivo que contém o ícone e o título do ícone selecionado pelo usuário. Esse membro é preenchido na saída.

sizel

O tamanho do objeto conforme exibido em sua origem, se o aspecto de exibição escolhido pelo usuário corresponder ao aspecto exibido na origem. Se o usuário escolher um aspecto diferente, sizel.cx e sizel.cy serão definidos como zero. O tamanho do objeto como ele é exibido na origem será recuperado do ObjectDescriptor se fLink for FALSE e do LinkSrcDescriptor se fLink for TRUE. Esse membro é preenchido na saída.

Comentários

Observação

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 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

OLEUIPASTEENTRY

OLEUIPASTEFLAG

Oleuipastespecial