Estrutura OLEUIPASTEENTRYA (oledlg.h)
Uma matriz de entradas a ser especificada na estrutura OLEUIPASTESPECIAL para a caixa de diálogo Colar Especial . Cada entrada inclui uma estrutura FORMATETC que especifica os formatos aceitáveis, uma cadeia de caracteres que representa o formato na caixa de listagem da caixa de diálogo, uma cadeia de caracteres para personalizar o texto do resultado da caixa de diálogo e um conjunto de sinalizadores da enumeração OLEUIPASTEFLAG . Os sinalizadores indicam se a entrada é válida apenas para colar, vinculando somente ou colando e vinculando. Se a entrada for válida para vinculação, os sinalizadores indicarão quais tipos de link são aceitáveis por OR'ing juntos os valores apropriados OLEUIPASTE_LINKTYPEn .
Sintaxe
typedef struct tagOLEUIPASTEENTRYA {
FORMATETC fmtetc;
LPCSTR lpstrFormatName;
LPCSTR lpstrResultText;
DWORD dwFlags;
DWORD dwScratchSpace;
} OLEUIPASTEENTRYA, *POLEUIPASTEENTRYA, *LPOLEUIPASTEENTRYA;
Membros
fmtetc
Formato aceitável. A caixa de diálogo Colar Especial verifica se esse formato é oferecido pelo objeto na área de transferência e, em caso afirmativo, oferece-o para seleção para o usuário.
lpstrFormatName
Ponteiro para a cadeia de caracteres que representa o formato para o usuário. Qualquer %s nessa cadeia de caracteres é substituído pelo FullUserTypeName do objeto na área de transferência e a cadeia de caracteres resultante é colocada na caixa de listagem da caixa de diálogo. Somente um %s é permitido. A presença ou ausência de %s especifica se o resultado-texto deve indicar que os dados estão sendo colados ou se um objeto que pode ser ativado por um aplicativo está sendo colado. Se %s estiver presente, o texto resultante indicará que um objeto está sendo colado. Caso contrário, ele diz que os dados estão sendo colados.
lpstrResultText
Ponteiro para a cadeia de caracteres usada para personalizar o texto resultante da caixa de diálogo quando o usuário seleciona o formato correspondente a essa entrada. Qualquer %s nessa cadeia de caracteres é substituído pelo nome do aplicativo ou FullUserTypeName do objeto na área de transferência. Somente um %s é permitido.
dwFlags
Valores da enumeração OLEUIPASTEFLAG .
dwScratchSpace
Espaço de risco disponível para rotinas que percorrem um IEnumFORMATETC para marcar se o formato PasteEntry está disponível. Esse campo pode ser deixado sem inicialização.
Comentários
Observação
O cabeçalho oledlg.h define OLEUIPASTEENTRY 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 |