Estructura OLEUIPASTESPECIALW (oledlg.h)
Contiene información que usa la biblioteca de interfaz de usuario OLE para inicializar el cuadro de diálogo Pegar especial , así como espacio para que la biblioteca devuelva información cuando se descarte el cuadro de diálogo.
Sintaxis
typedef struct tagOLEUIPASTESPECIALW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
LPDATAOBJECT lpSrcDataObj;
LPOLEUIPASTEENTRYW arrPasteEntries;
int cPasteEntries;
UINT *arrLinkTypes;
int cLinkTypes;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
int nSelectedIndex;
BOOL fLink;
HGLOBAL hMetaPict;
SIZEL sizel;
} OLEUIPASTESPECIALW, *POLEUIPASTESPECIALW, *LPOLEUIPASTESPECIALW;
Miembros
cbStruct
El tamaño de la estructura en bytes. Este miembro debe rellenarse en la entrada.
dwFlags
En la entrada, dwFlags especifica las marcas de inicialización y creación. Al salir, especifica las opciones del usuario. Puede ser una combinación de las marcas siguientes.
| Valor | Significado |
|---|---|
|
El cuadro de diálogo mostrará un botón Ayuda . |
|
El botón de radio Pegar se seleccionará al iniciar el cuadro de diálogo. Este es el valor predeterminado, si no se especifican PSF_SELECTPASTE o PSF_SELECTPASTELINK. Además, especifica el estado del botón en la finalización del diálogo. Marca IN/OUT. |
|
El botón de radio PasteLink se seleccionará al iniciar el cuadro de diálogo. Además, especifica el estado del botón al finalizar el diálogo. Marca IN/OUT. |
|
Indica si se ha activado el botón de radio Mostrar como icono al finalizar el cuadro de diálogo. Marca OUT. |
|
La casilla Mostrar como icono se deshabilitará al inicializar. |
|
Se usa para deshabilitar el botón cambiar icono en el cuadro de diálogo, que está disponible para los usuarios cuando pegan un objeto OLE de forma predeterminada. Vea STAYONCLIPBOARDCHANGE en caso contrario. |
|
Se usa para indicar al cuadro de diálogo que permanezca al día si el Portapapeles cambia mientras el cuadro de diálogo está arriba. Si el usuario cambia a otra aplicación y copia o corta algo, el cuadro de diálogo, de forma predeterminada, realizará una operación de cancelación, que quitará el cuadro de diálogo, ya que las opciones que se encuentran en medio de presentar al usuario ya no están actualizadas con respecto a lo que realmente está en el Portapapeles. |
|
Se usa junto con STAYONCLIPBOARDCHANGE (no hace nada de lo contrario). Si el Portapapeles cambia mientras el cuadro de diálogo está arriba y se especifica STAYONCLIPBOARDCHANGE , NOREFRESHDATAOBJECT indica que el cuadro de diálogo NO debe actualizar el contenido del cuadro de diálogo para reflejar el nuevo contenido del Portapapeles. Esto resulta útil si la aplicación usa el cuadro de diálogo especial paste-special en un IDataObject además del del Portapapeles, por ejemplo, como parte de una operación de arrastrar y colocar. |
hWndOwner
Ventana propietaria del cuadro de diálogo. Este miembro no debe ser NULL.
lpszCaption
Puntero a una cadena que se va a usar como título del cuadro de diálogo. Si es NULL, la biblioteca usa Paste Special.
lpfnHook
Puntero a una función de enlace que procesa los mensajes destinados al cuadro de diálogo. La función de enlace debe devolver cero para pasar un mensaje que no se procesó de nuevo en el procedimiento del cuadro de diálogo de la biblioteca. La función de enlace debe devolver un valor distinto de cero para evitar que el procedimiento del cuadro de diálogo de la biblioteca procese un mensaje que ya ha procesado.
lCustData
Datos definidos por la aplicación a los que pasa la biblioteca a la función de enlace a la que apunta el miembro lpfnHook . La biblioteca pasa un puntero a la estructura OLEUIPASTESPECIAL en el parámetro lParam del mensaje WM_INITDIALOG; este puntero se puede usar para recuperar el miembro lCustData .
hInstance
Instancia que contiene una plantilla de cuadro de diálogo especificada por el miembro lpTemplateName .
lpszTemplate
Puntero a una cadena terminada en NULL que especifica el nombre del archivo de recursos para la plantilla de cuadro de diálogo que se va a sustituir por la plantilla del cuadro de diálogo Pegar especial de la biblioteca.
hResource
Identificador de plantilla personalizado.
lpSrcDataObj
Puntero a la interfaz IDataObject del objeto de datos que se va a pegar (desde el Portapapeles). Este miembro se rellena en la entrada. Si lpSrcDataObj es NULL cuando se llama a OleUIPasteSpecial , OleUIPasteSpecial intentará recuperar un puntero a un IDataObject desde el Portapapeles. Si OleUIPasteSpecial se realiza correctamente, es responsabilidad del autor de la llamada liberar el IDataObject devuelto en lpSrcDataObj.
arrPasteEntries
Matriz OLEUIPASTEENTRY que especifica formatos aceptables. Este miembro se rellena en la entrada.
cPasteEntries
Número de entradas de matriz OLEUIPASTEENTRY . Este miembro se rellena en la entrada.
arrLinkTypes
Lista de tipos de vínculo que son aceptables. Se hace referencia a los tipos de vínculo mediante OLEUIPASTEFLAG en arrPasteEntries. Este miembro se rellena en la entrada.
cLinkTypes
Número de tipos de vínculo. Este miembro se rellena en la entrada.
cClsidExclude
Número de CLSID en lpClsidExclude. Este miembro se rellena en la entrada.
lpClsidExclude
Puntero a una matriz de CLSID que se va a excluir de la lista de objetos de servidor disponibles para una operación paste. Tenga en cuenta que esto no afecta a Pegar vínculo. Una aplicación puede impedir la inserción en sí misma enumerando su propio CLSID en esta lista. Este campo se rellena en la entrada.
nSelectedIndex
Índice de arrPasteEntries que el usuario seleccionó. Este miembro se rellena en la salida.
fLink
Indica si el usuario seleccionó Pegar o Pegar vínculo . Este miembro se rellena en la salida.
hMetaPict
Identificador del metarchivo que contiene el icono y el título del icono seleccionado por el usuario. Este miembro se rellena en la salida.
sizel
Tamaño del objeto tal como se muestra en su origen, si el aspecto de visualización elegido por el usuario coincide con el aspecto mostrado en el origen. Si el usuario elige un aspecto diferente, sizel.cx y sizel.cy se establecen en cero. El tamaño del objeto tal como se muestra en el origen se recupera del objectDescriptor si fLink es FALSE y del linkSrcDescriptor si fLink es TRUE. Este miembro se rellena en la salida.
Comentarios
Nota
El encabezado oledlg.h define OLEUIPASTESPECIAL como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | oledlg.h |