CommandTargetQuery (Evento)

Ocurre cuando un contenedor de documento activo actualiza su interfaz de usuario.

PROCEDURE Object.CommandTargetQuery
LPARAMETERS aCommands, nCommandTextFlag, cCommandTextOut

Parámetros

• aCommands
  Matriz de dos dimensiones que contiene una lista de comandos admitidos por el contenedor de documento activo.

  La primera columna de la matriz contiene valores numéricos que corresponden a los comandos admitidos por el contenedor de documento activo. Para obtener una lista de los comandos y sus valores numéricos, vea el parámetro nCommandID en CommandTargetExec (Evento).

  La segunda columna de la matriz contiene valores numéricos que corresponden al estado de compatibilidad para cada comando. La tabla siguiente muestra los valores que puede contener la segunda columna y el correspondiente estado de compatibilidad para los comandos.

  Valor	Constante FOXPRO.H	Descripción
  0	CMDF_NOTSUPPORTED	El objeto no admite este comando.
  1	CMDF_SUPPORTED	El objeto admite este comando.
  2	CMDF_ENABLED	El comando está disponible y habilitado.
  4	CMDF_LATCHED	El comando puede estar activado o desactivado, y actualmente está activado.
  8	CMDF_NINCHED	El comando puede estar activado o desactivado pero no se puede determinar su estado porque el atributo de este comando está en los dos estados en la selección relevante. Este estado corresponde a un estado "indeterminado" de una casilla de verificación de 3 estados, por ejemplo.

  La segunda columna de la matriz contiene inicialmente un valor cero para todos los comandos excepto CMDID_PROPERTIES. El código de evento debe almacenar un valor en la segunda columna para indicar el nivel de compatibilidad proporcionado por el documento activo para cada comando. Puede agregar cualquier combinación de valores para especificar niveles adicionales de compatibilidad. Por ejemplo, si se admite el procedimiento de documento activo para un comando (1), está disponible y habilitado (2), almacene 3 (1 + 2) en la segunda columna para el comando correspondiente.

  Para deshabilitar el elemento de menú Propiedades del menú Archivo, puede establecer el valor aCommands de la columna 2 de CMDID_PROPERTIES en 0. El valor predeterminado de la columna 2 para CMDID_PROPERTIES es 3 para dar soporte al cuadro de diálogo predeterminado Acerca de. Si desea obtener más información acerca del control de CMDID_PROPERTIES, vea CommandTargetExec (Evento).

• nCommandTextFlag
  Un parámetro que se pasa del contenedor de documento activo al evento CommandTargetExec. nCommandTextFlag indica el tipo de información de comando que se pasa al contenedor de documento activo mediante el parámetro cCommandTextOut. La tabla siguiente muestra los valores para nCommandTextFlag y la correspondiente información de comando que se va a pasar al contenedor de documento activo.

  nCommandTextFlag	Información de comando
  0	No se solicita información adicional.
  1	El documento activo debe proporcionar el nombre localizado para el comando.
  2	El documento activo debe proporcionar una cadena de barra de estado localizada para el comando.

• cCommandTextOut
  Un parámetro que se pasa desde el evento CommandTargetExec al contenedor de documento activo. cCommandTextOut es texto que se muestra para un comando, normalmente en la barra de estado del contenedor de documento activo. cCommandTextOut se aplica al comando de la primera fila de la matriz.

Observaciones

El evento CommandTargetQuery permite notificar a un contenedor de documento activo qué comandos admite el documento activo y el tipo de compatibilidad disponible para cada comando. También puede especificar el texto que se muestra cuando se selecciona un comando (normalmente un elemento de menú).

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.

Observe que las versiones 3 y 4 de Internet Explorer normalmente no piden el texto del comando mediante cCommandTextOut. Por tanto, nCommandTextFlag suele valer cero y cCommandTextOut normalmente contiene el valor nulo. Estos parámetros se incluyen para compatibilidad futura con la interfaz IOleCommandTarget y se pueden ignorar de forma segura en sus aplicaciones.

Vea también

CommandTargetExec (Evento) | Documentos activos

Se aplica a: ActiveDoc (Objeto)