Estructura OLEUICHANGESOURCEA (oledlg.h)

Contiene información que se usa para inicializar el cuadro de diálogo Cambiar origen estándar. Permite al usuario modificar el destino o el origen de un vínculo. Esto puede implicar simplemente seleccionar un nombre de archivo diferente para el vínculo o, posiblemente, cambiar la referencia de elemento dentro del archivo, por ejemplo, cambiar el intervalo de destino de celdas dentro de la hoja de cálculo a la que va el vínculo.

Sintaxis

typedef struct tagOLEUICHANGESOURCEA {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCSTR                lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCSTR                lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEA         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERA lpOleUILinkContainer;
  DWORD                 dwLink;
  LPSTR                 lpszDisplayName;
  ULONG                 nFileLength;
  LPSTR                 lpszFrom;
  LPSTR                 lpszTo;
} OLEUICHANGESOURCEA, *POLEUICHANGESOURCEA, *LPOLEUICHANGESOURCEA;

Miembros

cbStruct

Tamaño de la estructura, en bytes.

dwFlags

En la entrada, este campo 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
CSF_SHOWHELP	Habilita o muestra el botón Ayuda.
CSF_VALIDSOURCE	Indica que se validó el vínculo.
CSF_ONLYGETSOURCE	Deshabilita la validación automática del origen del vínculo cuando el usuario presiona Aceptar. Si especifica esta marca, debe validar el origen cuando el cuadro de diálogo devuelva Aceptar.

hWndOwner

Ventana propietaria del cuadro de diálogo.

lpszCaption

Puntero a una cadena que se va a usar como título del cuadro de diálogo. Si NULL , la biblioteca usa Cambiar origen.

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 al 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 haya procesado.

lCustData

Datos definidos por la aplicación a los que pasa la biblioteca a la función de enlace a la que apunta la estructura OLEUICHANGEICON en el parámetro lParam del mensaje de 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 de lpszTemplate. Este miembro se omite si el miembro de lpszTemplate es null o no es válido.

lpszTemplate

Puntero a una cadena terminada en NULL que especifica el nombre del archivo de recursos para la plantilla del cuadro de diálogo que se va a sustituir por la plantilla del cuadro de diálogo convertir biblioteca.

hResource

Identificador de recursos para un cuadro de diálogo personalizado. Si este miembro es null, la biblioteca usa la plantilla de cuadro de diálogo Convertir estándar o, si es válida, la plantilla denominada por el miembro lpszTemplate.

lpOFN

Puntero a la estructura de OPENFILENAME, que contiene información utilizada por el sistema operativo para inicializar los cuadros de diálogo Open o Guardar como definidos por el sistema.

dwReserved1[4]

Este miembro está reservado.

lpOleUILinkContainer

Puntero a la implementación del contenedor de la interfaz de IOleUILinkContainer, que se usa para validar el origen del vínculo. El cuadro de diálogo Editar vínculos lo usa para permitir que el contenedor manipule sus vínculos.

dwLink

Identificador de vínculo único definido por el contenedor que se usa para validar los orígenes de vínculo. Usado por lpOleUILinkContainer.

lpszDisplayName

Puntero al nombre para mostrar del origen completo.

nFileLength

Parte del moniker de archivo de lpszDisplayName.

lpszFrom

Puntero al prefijo del origen del que se cambió.

lpszTo

Puntero al prefijo del origen al que se va a cambiar.

Observaciones

Nota

El encabezado oledlg.h define OLEUICHANGESOURCE 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	oledlg.h

Consulte también

IOleUILinkContainer

OleUIChangeSource