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 |
---|---|
|
A caixa de diálogo exibirá um botão Ajuda . |
|
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. |
|
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. |
|
Se o botão de opção Exibir como Ícone foi marcado na terminação da caixa de diálogo. Sinalizador OUT. |
|
A caixa marcar Ícone Exibir como será desabilitada na inicialização. |
|
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. |
|
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. |
|
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte:Enviar e exibir comentários de