Estrutura OLEUIPASTESPECIALA (oledlg.h)

Artigo
11/20/2024

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 espaço para a biblioteca retornar informações quando a caixa de diálogo for descartada.

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. Na saída, 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 é o padrão, se PSF_SELECTPASTE ou PSF_SELECTPASTELINK não forem especificados. Além disso, 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 PasteLink será selecionado na inicialização da caixa de diálogo. Além disso, especifica o estado do botão no encerramento da caixa de diálogo. Sinalizador IN/OUT.
PSF_CHECKDISPLAYASICON	Se o botão Exibir Como Ícone o botão de opção foi marcado na terminação da caixa de diálogo. Sinalizador OUT.
PSF_DISABLEDISPLAYASICON	A caixa de seleção Exibir como Ícone 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 cima se a área de transferência for alterada enquanto a caixa de diálogo estiver pronta. Se o usuário alternar para outro aplicativo e copiar ou cortar algo, a caixa de diálogo executará, por padrão, uma operação de cancelamento, que removerá a caixa de diálogo, pois as opções que ele está no meio da apresentação ao usuário não serão mais up-to-date 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 pronta 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 especial de colagem em um IDataObject além daquela na á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 NULL, a biblioteca usará ColarEspecial.

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 de gancho 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 de 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 da caixa de diálogo que deve ser substituído pelo modelo da 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 estiver NULL quando OleUIPasteSpecial for chamado, OleUIPasteSpecial tentará recuperar um ponteiro para um IDataObject da área de transferência. Se OleUIPasteSpecial for bem-sucedida, é 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 no lpClsidExclude. Esse membro é preenchido na entrada.

lpClsidExclude

Ponteiro para uma matriz de CLSIDs a ser excluída da lista de objetos de servidor disponíveis para uma operação De colar. Observe que isso não afeta de Link de Colagem. 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 de Link de Colagem foi selecionado pelo usuário. Esse membro é preenchido na saída.

hMetaPict

Manipule para o Metafile 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 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 exibido na origem será recuperado do ObjectDescriptor se fLink for FALSE e do LinkSrcDescriptor se fLink estiver VERDADEIRO. Esse membro é preenchido na saída.

Observações

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]
cabeçalho	oledlg.h

Consulte também

OLEUIPASTEENTRY

OLEUIPASTEFLAG

OleUIPasteSpecial

Compartilhar via