4D Doc Center : CT Get refnum

4D Chart v13

CT Get refnum


CT Get refnum ( area ; alcance ) -> Resultado

Parámetro	Tipo	Descripción
area	Entero largo	Área 4D Chart
alcance	Entero largo	Alcance del comando -2 = Por defecto, -1 = Todo, 0 = Objetos seleccionados >0 = ID del objeto
Resultado	Entero largo	Número de referencia para los objetos en área

Descripción

CT Get refnum devuelve el número de referencia para el objeto(s) en el área descrita por alcance. Un número de referencia es un entero largo asociado a un objeto y no es necesariamente único. Los números de referencia sólo pueden manipularse por programación. Usted asigna un número de referencia a un objeto. El identificador del objeto, por otra parte, es asignado por 4D Chart.

Si alcance es igual a -2, CT Get refnum devuelve el número de referencia por defecto.
Si el alcance es igual a -1, CT Get refnum devuelve el número de referencia para todos los objetos en el documento. Si los números de referencia para los objetos no son iguales, CT Get refnum devuelve -32000.
Si el alcance es igual a 0, CT Get refnum devuelve el número de referencia para los objetos seleccionados. Si los números de referencia para los objetos no son iguales, CT Get refnum devuelve -32000.
Si el alcance es mayor que 0, debe ser igual al ID de un objeto específico y se devuelve el número de referencia de ese objeto. Si el objeto no existe, CT Get refnum devuelve -32000.

Ejemplo

Este ejemplo es el método de objeto de un botón en un formulario que contiene un área 4D Chart. Cuando el método se ejecuta, verifica si sólo un objeto está seleccionado, busca en la tabla [Partes] el registro correspondiente y muestra su descripción.

 QUERY([Parts];[Parts]RefNum=CT Get refnum(Area;0))

 ALERT("Este objeto es un "+[Parts]Description)