Command name

Command name ( comando {; info {; theme}} ) : Text

Parámetro	Tipo		Descripción
comando	Integer	→	Número del comando
info	Integer	←	Propiedad hilo seguro del comando
theme	Text	←	Tema del lenguaje del comando
Resultado	Text	←	Nombre del comando traducido

Descripción

El comando Command name devuelve el nombre y (opcionalmente) las propiedades del comando cuyo número se pasa en comando.el número de cada comando está indicado en el Explorador, así como también en el área de Propiedades de esta documentación.

Nota de compatibilidad: como el nombre de un comando puede variar de una versión 4D a otra (comandos renombrados), este comando se utilizó en versiones anteriores del programa para designar un comando directamente por medio de su número, especialmente en partes de código no tokenizadas. Esta sintaxis permite evitar posibles problemas debido a las variaciones en los nombres de los comandos, así como otros elementos tales como tablas, sin dejar de poder escribir estos nombres de forma legible (para obtener más información sobre este punto, consulte la sección Utilizar tokens en fórmulas). Además, de forma predeterminada, la versión en Inglés del lenguaje se utiliza a partir de 4D v15; Sin embargo, la opción "Utilizar la configuración del sistema regional" en la Is a list de las Preferencias le permite continuar con el uso de la versión en español en un 4D en español.

Dos parámetros opcionales están disponibles:

• info: propiedades del comando. El valor devuelto es un campo de bits, donde actualmente sólo el primer bit (bit 0) es significativo. Se pone en 1 si el comando es hilo seguro (es decir, compatible con la ejecución de un proceso apropiativo) y 0 si es hilo-inseguro. Sólo los comandos compatibles con el proceso se pueden utilizar en los procesos apropiativos. Para más información sobre este punto, consulte la sección Procesos 4D apropiativos.
• tema: devuelve el nombre del tema del comando en el lenguaje 4D.

El comando Command name define la variable OK en 1 si comando corresponde a un número de comando existente y a 0 en caso contrario. Tenga en cuenta, sin embargo, que algunos comandos existentes han sido desactivados, en cuyo caso Command name devuelve una cadena vacía (ver el último ejemplo).

Ejemplo 1

El siguiente código le permite cargar todos los comandos 4D válidos en un array:

 var $Lon_id : Integer
 var $Txt_command : Text
 ARRAY LONGINT($tLon_Command_IDs;0)
 ARRAY TEXT($tTxt_commands;0)
 
 Repeat
    $Lon_id:=$Lon_id+1
    $Txt_command:=Command name($Lon_id)
    If(OK=1) //el número de comando existe
       If(Length($Txt_command)>0) //el comando no está desactivado
          APPEND TO ARRAY($tTxt_commands;$Txt_command)
          APPEND TO ARRAY($tLon_Command_IDs;$Lon_id)
       End if
    End if
 Until(OK=0) //fin de los comandos existentes

Ejemplo 2

En un formulario, usted quiere mostrar una lista desplegable que contenga los comandos estándar de generación de informes. En el método de objeto de esta lista desplegable, usted escribe:

 Case of
    :(Form event code=On Before)
       ARRAY TEXT(asCommand;4)
       asCommand{1}:=Command name(1)
       asCommand{2}:=Command name(2)
       asCommand{3}:=Command name(4)
       asCommand{4}:=Command name(3)
  // ...
 End case

En la versión inglesa de 4D, la lista desplegable contendrá: Sum, Average, Min, y Max. En la versión francesa* de 4D, la lista desplegable contendrá: Somme, Moyenne, Min, y Max.

*con la aplicación 4D configurada para ser utilizada en idioma francés (ver nota de compatibilidad).

Ejemplo 3

Desea crear un método que devuelva True si el comando, cuyo número se pasa como parámetro, es hilo seguro y en caso contrario False.

  //Método proyecto Is_Thread_Safe
  //Is_Thread_Safe(numCom) -> Booleano
 
 var $1;$threadsafe : Integer
 var $name : Text
 var $0 : Boolean
 $name:=Command name($1;$threadsafe;$theme)
 If($threadsafe ?? 0) //si el primer bit se define en 1
    $0:=True
 Else
    $0:=False
 End if

Luego, para el comando "SAVE RECORD" (53) por ejemplo, puede escribir:

 $isSafe:=Is_Thread_Safe(53)
  // devuelveTrue

Ver también

EXECUTE FORMULA
Procesos 4D apropiativos

Propiedades

Número de comando	538
Hilo seguro	✓
Modifica variables	OK