Difference: CDOverviewKeyConceptsEs (1 vs. 3)

Revision 32013-02-16 - RayPelegrino

Line: 1 to 1

META TOPICPARENT	name="CDOverviewKeyConcepts"

Conceptos Clave

Esta página describe los conceptos clave que usted debe saber antes de usar el API's.

Changed:

<
<

Descriptión:

>
>

Descripción:

Las APIs se han sido diseñado para que tenga un número mínimo de parámetros para pasar. Ellos usan el concepto de "objeto actual", en el objeto puede hacer referencia a una etiqueta, conjunto de datos, gráficos, etc En otras palabras, al agregar datos a un gráfico, usted no tiene que decirle a la API de tabla que está incluyendo para, automáticamente se agregará a el gráfico "actual". Semejantemente, al decir a la API para representar un gráfico, no tiene que decirle qué tabla, también se procesa automáticamente el gráfico "actual". O bien, cuando se crea una etiqueta para el gráfico, la etiqueta que acaba de crear se convertirá en la "corriente" etiqueta y cuando se llama a las rutinas de la API para establecer los atributos de fuente, color u otro, automáticamente se aplicará a esa etiqueta. Si está trabajando con más de una gráfico a la vez, puede nombrar a cada gráfico a medida que lo inicialice y use una API para cambiar el gráfico actual en una de las listas mencionadas. También puede nombrar conjuntos de datos, formas y otros objetos. Normalmente sólo es necesario hacer esto si usted está trabajando con más de uno de estos a la vez, de lo contrario, dejando en blanco el nombre es suficiente.
El API puede tener uno o más parámetros requeridos y uno o más parámetros opcionales. Si usted no puede PASS un parámetro requerido, la API va cancelar con un mensaje de error que indica que el parámetro que falta. Cuando se pasan parámetros opcionales, puede ser que tenga que pasar los parámetros ficticios para rellenar los espacios vacios. Por ejemplo, si una API tiene 3 parámetros opcionales, y desea PASS el valor de a para el segundo parámetro, entonces usted tendrá que PASS algo para el parámetro opcional, luego entonces el valor que desee para el segundo parámetro. De lo contrario, la API asociará su valor con el primer parámetro opcional, no el segundo.

Revision 22013-02-15 - RayPelegrino

 			 META TOPICPARENT 
			 name="CDOverviewKeyConcepts"
- META TOPICPARENT
+ name="CDOverviewKeyConcepts"
-<
<
+ KEY CONCEPTS (Spanish)
->
>
+ Conceptos Clave
-<
<
+This page describes the key concepts you should know before using the API's.
->
>
+Esta página describe los conceptos clave que usted debe saber antes de usar el API's.
-<
<
+ Description:
->
>
+ Descriptión:
-<
<
+The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. Or, when you create a label for your chart, the label just created will become the 'current' label and when you call other API routines to set the font, color or other attributes, it will automatically apply to that label. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts. You can also name datasets, shapes and other objects. Normally you only need to do this if you are working with more than one of these at a time, otherwise, leaving the name blank will suffice.
->
>
+ Las APIs se han sido diseñado para que tenga un número mínimo de parámetros para pasar. Ellos usan el concepto de "objeto actual", en el objeto puede hacer referencia a una etiqueta, conjunto de datos, gráficos, etc En otras palabras, al agregar datos a un gráfico, usted no tiene que decirle a la API de tabla que está incluyendo para, automáticamente se agregará a el gráfico "actual". Semejantemente, al decir a la API para representar un gráfico, no tiene que decirle qué tabla, también se procesa automáticamente el gráfico "actual". O bien, cuando se crea una etiqueta para el gráfico, la etiqueta que acaba de crear se convertirá en la "corriente" etiqueta y cuando se llama a las rutinas de la API para establecer los atributos de fuente, color u otro, automáticamente se aplicará a esa etiqueta. Si está trabajando con más de una gráfico a la vez, puede nombrar a cada gráfico a medida que lo inicialice y use una API para cambiar el gráfico actual en una de las listas mencionadas. También puede nombrar conjuntos de datos, formas y otros objetos. Normalmente sólo es necesario hacer esto si usted está trabajando con más de uno de estos a la vez, de lo contrario, dejando en blanco el nombre es suficiente.
 El API puede tener uno o más parámetros requeridos y uno o más parámetros opcionales. Si usted no puede PASS un parámetro requerido, la API va cancelar con un mensaje de error que indica que el parámetro que falta. Cuando se pasan parámetros opcionales, puede ser que tenga que pasar los parámetros ficticios para rellenar los espacios vacios. Por ejemplo, si una API tiene 3 parámetros opcionales, y desea PASS el valor de a para el segundo parámetro, entonces usted tendrá que PASS algo para el parámetro opcional, luego entonces el valor que desee para el segundo parámetro. De lo contrario, la API asociará su valor con el primer parámetro opcional, no el segundo.
-<
<
+The API's may have one or more required parameters and one or more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.
->
>
+ Los parámetros para la API de mayúsculas y minúsculas, entonces TOPLEFT es lo mismo que tOpLeFt o tOPLEFt.
 Por cada API, hay un campo de trabajo del mismo nombre que va a contener los códigos de retorno de la API. Usted puede probar este campo de trabajo para un valor en blanco no después de regresar para ver si ha ocurrido un error. Los campos de trabajo son token, por lo que se puede SCAN los valores posibles en el editor de ILF.
 Los nombres de API comenzar con un período de distinguir las rutinas externas de las internas. Usted se dará cuenta de una serie de otras subrutinas en la aplicación 0CD que no empiezan con un punto. Estas son las subrutinas internas utilizadas por la propia API, no trates de llamar directamente.
 La aplicación 1CD contiene una serie de ejemplos, se utiliza como referencia hasta que se familiarice con el uso de la API. Los ejemplos que vienen directamente de las muestras en la documentación Chart Director.
 Por último, los ejemplos de código que figuran en el wiki están diseñados para ser copiado y pegado en su propio proceso. Usted debe ser capaz de seleccionar el código de ejemplo, copiarlo en el clipboard y luego pegarlo en el editor ILF a través de la opción 8.
-<
<
+The parameters for the API's are case insensitive, so TOPLEFT is the same as tOpLeFt or tOPLEFt.

For every API, there is a work field of the same name that will contain any return codes from the API. You can test this work field for a non blank value after returning to see if an error occurred. The work fields are tokenized, so you can SCAN the possible values in the ILF editor.

The API names begin with a period to distinguish the external routines from the internal ones. You will notice a number of other subroutines in the 0CD application that do not begin with a period. These are the internal subroutines used by the API itself, do not try to call them directly.

The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's. The examples come directly from the samples in the Chart Director documentation.

Finally, the code examples given in the wiki are designed to be copied and pasted into your own process. You should be able to select the example code, copy it to the clipboard and then paste it into the ILF editor via Option 8.
 Comments
->
>
+ Comentarios
 Read what other users have said about this page or add your own comments.

Revision 12013-02-14 - RayPelegrino

Line: 1 to 1

Added:

>
>

META TOPICPARENT	name="CDOverviewKeyConcepts"

KEY CONCEPTS (Spanish)

This page describes the key concepts you should know before using the API's.

Description:

The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. Or, when you create a label for your chart, the label just created will become the 'current' label and when you call other API routines to set the font, color or other attributes, it will automatically apply to that label. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts. You can also name datasets, shapes and other objects. Normally you only need to do this if you are working with more than one of these at a time, otherwise, leaving the name blank will suffice.

The API's may have one or more required parameters and one or more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.

The parameters for the API's are case insensitive, so TOPLEFT is the same as tOpLeFt or tOPLEFt.

For every API, there is a work field of the same name that will contain any return codes from the API. You can test this work field for a non blank value after returning to see if an error occurred. The work fields are tokenized, so you can SCAN the possible values in the ILF editor.

The API names begin with a period to distinguish the external routines from the internal ones. You will notice a number of other subroutines in the 0CD application that do not begin with a period. These are the internal subroutines used by the API itself, do not try to call them directly.

The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's. The examples come directly from the samples in the Chart Director documentation.

Finally, the code examples given in the wiki are designed to be copied and pasted into your own process. You should be able to select the example code, copy it to the clipboard and then paste it into the ILF editor via Option 8.

Comments

Read what other users have said about this page or add your own comments.

<--/commentPlugin-->

-- JeanNeron - 2011-09-15

View topic | History: r3 < r2 < r1 | More topic actions...