Estructura OLEUICHANGESOURCEA (oledlg.h)

  • Artículo

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 las 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

El 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 es NULL, la biblioteca usa Change Source.

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 ha procesado.

lCustData

Datos definidos por la aplicación que la biblioteca pasa 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 lpszTemplate . Este miembro se omite si el miembro 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 de cuadro de diálogo que se va a sustituir por la plantilla de cuadro de diálogo Convertir de la 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 OPENFILENAME , que contiene información utilizada por el sistema operativo para inicializar los cuadros de diálogo Abrir o Guardar como definidos por el sistema.

dwReserved1[4]

Este miembro está reservado.

lpOleUILinkContainer

Puntero a la implementación del contenedor de la interfaz 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.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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

Consulte también

IOleUILinkContainer

OleUIChangeSource