CommandTargetExec (Evento)
Se produce cuando un contenedor de documentos activos notifica al documento activo el comando que se va a ejecutar.
PROCEDURE Object.CommandTargetExec
LPARAMETERS nCommandID, nExecOption, eArgIn, eArgOut
Parámetros
nCommandID
Un parámetro que pasa el contenedor de documentos activos al evento CommandTargetExec para indicar el comando que se va a ejecutar. La tabla siguiente muestra los valores pasados al evento que Visual FoxPro puede procesar y el correspondiente comando que se ejecutará.nCommandID Constante FOXPRO.H (Comando) 1 CMDID_OPEN Comando Abrir del menú Archivo. 2 CMDID_NEW Comando Nuevo del menú Archivo. 3 CMDID_SAVE Comando Guardar del menú Archivo. 4 CMDID_SAVEAS Comando Guardar como del menú Archivo. 5 CMDID_SAVECOPYAS Comando Guardar copia como del menú Archivo. 6 CMDID_PRINT Comando Imprimir del menú Archivo. 7 CMDID_PRINTPREVIEW Comando Vista preliminar del menú Archivo. 8 CMDID_PAGESETUP Comando Configurar página del menú Archivo. 9 CMDID_SPELL Comando Corrector ortográfico del menú Herramientas. 10 CMDID_PROPERTIES Comando Propiedades del menú Archivo. 11 CMDID_CUT Comando Cortar del menú Edición. 12 CMDID_COPY Comando Copiar del menú Edición. 13 CMDID_PASTE Comando Pegar del menú Edición. 14 CMDID_PASTESPECIAL Comando Pegado especial del menú Edición. 15 CMDID_UNDO Comando Deshacer del menú Edición. 16 CMDID_REDO Comando Rehacer del menú Edición. 17 CMDID_SELECTALL Comando Seleccionar todo del menú Edición. 18 CMDID_CLEARSELECTION Comando Borrar del menú Edición. 19 CMDID_ZOOM Comando Zoom del menú Ver. 20 CMDID_GETZOOMRANGE Obtiene el intervalo de zoom aplicable al comando Zoom del menú Ver. 21 CMDID_UPDATECOMMANDS Notifica al documento activo los cambios de estado. 22 CMDID_REFRESH Pide al documento activo que actualice su presentación. Lo implementa el documento activo. 23 CMDID_STOP Pide al documento activo que detenga su procesamiento. 24 CMDID_HIDETOOLBARS Pide al documento activo que oculte sus barras de herramientas. Lo implementa el documento activo. 25 CMDID_SETPROGRESSMAX Establece el valor máximo del indicador de progreso. 26 CMDID_SETPROGRESSPOS Establece el valor actual del indicador de progreso. 27 CMDID_PROGRESSTEXT Establece el texto contenido en el indicador de progreso. 28 CMDID_SETTITLE Establece el texto de la barra de título. 29 CMDID_DOWNLOADSTATE Lo envía el contenedor cuando cambia el estado de descarga. 30 CMDID_STOPDOWNLOAD Detiene la descarga cuando se ejecuta. 31 CMDID_ONTOOLBARACTIVATED Una de las barras de herramientas del contenedor ha recibido el enfoque. 36 CMDID_ENABLE_INTERACTION Lo envía el contenedor del documento activo para indicar al documento activo que detenga o reanude cualquier operación multimedia (audio o animación) del documento activo. Establece un valor verdadero (1) para eArgIn si se debe reanudar un archivo multimedia que se ejecuta en un control del documento activo, o falso (0) si se debe hacer una pausa en el archivo multimedia.
Internet Explorer 4.0 utiliza este comando para informar a un documento activo cuando está minimizado o cubierto completamente por otra ventana de forma que pueda detener la reproducción de la información multimedia.
37 CMDID_ONUNLOAD Lo envía el contenedor de documento activo antes de iniciar la exploración de otro sitio o antes de cerrarse. Establece eArgOut como falso (.F.) para evitar que un host cierre su documento activo. Establece eArgOut como verdadero (.T.) para permitir que un contenedor cierre su documento activo. nExecOption
Un parámetro que se pasa al evento CommandTargetExec para indicar la acción predeterminada deseada para el comando especificado.La tabla siguiente muestra los valores de nExecOption y las acciones que se realizan.
nExecOption Constante FOXPRO.H Acción 0 CMDEXECOPT_DODEFAULT Adoptar el comportamiento predeterminado, ya sea pedir información al usuario o no. 1 CMDEXECOPT_PROMPTUSER Ejecutar el comando después de obtener información del usuario. 2 CMDEXECOPT_DONTPROMPTUSER Ejecutar el comando sin pedir información al usuario. Por ejemplo, si hace clic en el botón Imprimir de la barra de herramientas, se imprimirá automáticamente un documento sin información del usuario 3 CMDEXECOPT_SHOWHELP Muestra Ayuda para el comando correspondiente, pero no ejecuta el comando. eArgIn
Un parámetro pasado desde el contenedor de documento activo al evento CommandTargetExec. Generalmente este parámetro es el valor nulo, pero con la notable excepción de nCommandID=36. Cuando nCommandID vale 36, eArgIn contiene un valor. Vea la tabla de la descripción del parámetro nCommandID para obtener más información acerca del valor lógico pasado a eArgIn.eArgOut
Un parámetro de resultado devuelto desde el evento CommandTargetExec al contenedor de documento activo. Generalmente este parámetro es el valor nulo, con la notable excepción de nCommandID=37. Cuando nCommandID vale 37 (lo que indica que el contenedor de documento activo va a cerrarse o explorar otro sitio), puede establecer eArgOut en falso (.F.) para impedir que el host cierre el documento activo. Establezca eArgOut en verdadero (.T.) para permitir que el host cierre el documento activo.
Observaciones
El evento CommandTargetExec permite que un documento activo realice acciones personalizadas en función de los comandos enviados por el host a su documento activo. Estos comandos se pueden enviar como respuesta a que el usuario elija un elemento de menú o de barra de herramientas, o al desencadenamiento de un evento en el contenedor de documento activo. El valor devuelto por el evento CommandTargetExec notifica al contenedor de documento activo que el usuario ha controlado el comando. Si no ha controlado el comando, el contenedor de documento activo puede realizar su propio procesamiento personalizado del comando.
La tabla siguiente muestra los valores apropiados que devuelve el evento CommandTargetExec.
| Valor devuelto | Constante FOXPRO.H | Acción del comando |
|---|---|---|
| 0 | CMD_OK | El documento activo ha controlado correctamente el comando.
Devuelve este valor cuando el documento activo ha controlado el comando identificado con nCommandID. Por ejemplo, si se elige el comando Abrir del menú Archivo en el host, el documento activo puede determinar en su evento CommandTargetExec que nCommandID es 1 y ejecutar su propia rutina para abrir archivos, tal vez con la función GETFILE( ) de Visual Foxpro. |
| 1 | CMD_NOTSUPPORTED | Comando no admitido por el documento activo.
Devuelve este valor cuando no se reconoce el comando identificado con nCommandID como un comando que puede controlar el documento activo. |
| 2 | CMD_DISABLED | Comando desactivado para el documento activo.
Devuelve este valor cuando el comando identificado con nCommandID está deshabilitado y no puede ejecutarlo el documento activo. |
| 3 | CMD_NOHELP | No hay Ayuda disponible para el comando en el documento activo.
Devuelve este valor cuando el documento activo no admite Ayuda para el comando identificado con nCommandID. |
| 4 | CMD_CANCELED | El usuario ha cancelado la ejecución del comando.
Devuelve este valor cuando el documento activo intenta controlar el comando identificado con nCommandID pero el usuario cancela la operación. |
Si el evento CommandTargetExec no contiene código de usuario, se devuelve 2 (comando no admitido por el documento activo) al contenedor de documento activo. Si el evento CommandTargetExec contiene código de usuario pero no incluye una instrucción RETURN, se devuelve 0 (comando correctamente controlado por el documento activo) al contenedor de documento activo.
Visual FoxPro utiliza la interfaz IOleCommandTarget para los eventos CommandTargetExec y CommandTargetQuery. Busque IOleCommandTarget en la biblioteca MSDN para obtener información adicional acerca de cómo se implementan estos eventos.
Puede controlar la presentación del cuadro de diálogo "Acerca del tiempo de ejecución de Microsoft Visual FoxPro" mediante CMDID_PROPERTIES en el parámetro nCommand.
Para mostrar el cuadro de diálogo
Devuelva CMD_NOTSUPPORTED (1) desde el evento CommandTargetExec.
Para suprimir el cuadro de diálogo
Devuelva CMD_OK (0) desde el evento CommandTargetExec. Si no hay código en el evento CommandTargetExec, la acción predeterminada para Visual FoxPro es mostrar el cuadro de diálogo "Acerca del tiempo de ejecución de Microsoft Visual FoxPro".
Vea también
CommandTargetQuery (Evento) | GETFILE( ) (Función)
Se aplica a: ActiveDoc (Objeto)