Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Este tema no está actualizado. Para obtener la información más reciente, consulte el Especificación de esquema de impresión .
Un elemento ParameterDef difiere de un elemento ParameterInit en que describe el valor que puede contener un elemento ParameterInit, mientras que un elemento ParameterInit asigna un valor al parámetro . Un elemento ParameterDef consta de un conjunto específico de elementos Property, que son elementos secundarios del elemento ParameterDef, que especifican el tipo de datos, los valores máximos, mínimos y predeterminados de los datos y otra información. Estos elementos Property se describen más adelante en este tema.
Los elementos ParameterDef solo pueden aparecer en su contexto permitido. Para la versión inicial del esquema de impresión, pueden encontrarse en el nivel raíz del documento PrintCapabilities. El atributo name del elemento ParameterDef define el nombre del parámetro. A cada elemento ParameterDef del documento PrintCapabilities se le debe asignar un atributo de nombre único.
Nota
para imprimir proveedores de documentos de funcionalidades:
El significado de un nombre de parámetro es universal; es decir, si un elemento ParameterDef de un documento PrintCapabilities tiene el mismo atributo de nombre (la cadena formada por el espacio de nombres y el nombre descriptivo del elemento ParameterDef) como un elemento ParameterDef en otro documento PrintCapabilities, se supone que ambos elementos representan el mismo concepto y deben interpretarse de la misma manera. Por lo tanto, se puede usar un elemento ParameterDef definido en un printTicket para un documento PrintCapabilities para inicializar el elemento ParameterInit del mismo nombre definido en un documento PrintCapabilities diferente.
Relación con atributos XML
Como es true de todos los atributos de nombre, el nombre del parámetro tiene la forma de un QName XML. Una construcción de parámetro definida por el esquema tiene un nombre calificado por el espacio de nombres público, formando el atributo name, mientras que el atributo name de una construcción de parámetros definida de forma privada está calificado por un espacio de nombres privado que es único para el creador.
Relación entre ParameterDef y los tipos de elementos de propiedad
Los elementos ParameterDef definidos en las palabras clave del esquema de impresión deben definirse completamente en un documento PrintCapabilities. El documento Print Schema Keywords proporciona valores nominales para algunos elementos Property de un elemento ParameterDef (como DefaultValue y otros), pero el autor de un documento PrintCapabilities es responsable de definir los elementos Property restantes. En cualquier caso, todos los elementos Property deben definirse explícitamente en un elemento ParameterDef, incluidos los definidos en las palabras clave del esquema de impresión.
Algunos elementos Property de cada elemento ParameterDef que aparecen en las palabras clave de esquema de impresión se designan como inmutable. Esto significa que todas las definiciones de documento PrintCapabilities de los elementos ParameterDef definidos por Print Schema deben conservar estos elementos Property sin modificaciones. Estos elementos Property inmutables permiten que las construcciones de parámetros sean portátiles e inequívocas en todos los documentos PrintCapabilities. Un ejemplo primo es las unidades usadas en un elemento ParameterDef. Estas unidades deben ser inmutables, para promover una comprensión coherente de su significado. Los elementos de propiedad de un ParameterDef que se designan como no inmutables se pueden volver a definir dentro de un documento PrintCapabilities.
Un elemento ParameterDef se compone de los siguientes elementos Property. Todo debe estar presente a menos que se indique lo contrario.
| Nombre de propiedad | Valores | Descripción | ¿Inmutable? |
|---|---|---|---|
| Datatype |
entero decimal cuerda No hay ningún valor predeterminado. |
Especifica si el valor del parámetro es un número entero, un número de punto flotante o una cadena de texto. El valor de un parámetro se expresa en el mismo formato que el tipo de datos básico XSD correspondiente; es decir, como entero, decimal o cadena. |
Sí |
| DefaultValue |
Tipo especificado por la propiedad DataType. No hay ningún valor predeterminado. |
Especifica el valor con el que se inicializa un control de interfaz de usuario (UI).
|
No |
| Obligatorio |
Incondicional: siempre se debe proporcionar el elemento ParameterInit. Condicional: el elemento ParameterInit solo es necesario si se hace referencia al parámetro dentro de un elemento Option de printTicket. DefaultValue: condicional. |
Indica cuándo debe aparecer explícitamente un elemento ParameterInit. Si es Condicional, se debe inicializar ParameterInit si PrintTicket contiene una opción que hace referencia al parámetro . Usado por clientes de interfaz de usuario y proveedores PrintCapabilities o PrintTicket. Tenga en cuenta que, en cualquier restricción, la propiedad obligatoria del elemento ParameterDef debe establecerse en Incondicional. ParameterDef debe tener un valor definido; de lo contrario, no se pudo evaluar el valor o la restricción dependientes. |
No |
| MaxLength |
entero si DataType Property especifica la cadena. DefaultValue: no se aplica ningún valor máximo. |
Para los parámetros con valores de cadena, especifica la cadena permitida más larga. Los proveedores ui y PrintCapabilities o PrintTicket usan esta propiedad para validar el elemento ParameterDef. |
No |
| MaxValue |
entero si DataType Property especifica entero. decimal si DataType Property especifica decimal. DefaultValue: no se aplica ningún valor máximo. |
Para los elementos ParameterDef con valores enteros o decimales, define el valor permitido más grande. |
No |
| MinLength |
entero si DataType Property especifica la cadena. DefaultValue: no se aplica ningún valor mínimo. |
Para los valores de cadena, define la cadena más corta permitida. Los proveedores ui y PrintCapabilities o PrintTicket usan esta propiedad para validar el elemento ParameterDef. |
No |
| MinValue |
entero si DataType Property especifica entero. decimal si DataType Property especifica decimal. DefaultValue: no se aplica ningún valor mínimo. |
Para los parámetros con valores enteros o decimales, define el valor permitido más pequeño. |
No |
| Múltiple |
entero si DataType Property especifica entero. decimal si DataType Property especifica decimal. DefaultValue: 1 |
Para los parámetros con valores decimales o enteros, el valor del parámetro debe ser un múltiplo de este número. Para obtener más información, vea Notas sobre varios siguiendo esta tabla. |
No |
| UnitType |
valor de cadena que indica las unidades usadas para el parámetro . No hay ningún valor predeterminado. |
Indica las unidades en las que se expresa el parámetro. Por ejemplo, ángulos en décimas de grados, longitudes en micrones, etc. |
Sí |
Notas sobre varios
Para los elementos ParameterInit con valores enteros o decimales, el valor de ParameterInit debe ser un múltiplo de este número. Por ejemplo, los elementos ParameterInit con valores decimales se pueden limitar a décimo estableciendo esta propiedad en 0,1. Los elementos de la interfaz de usuario usan esta propiedad cuando construyen cuadros de diálogo y controles de interfaz de usuario. Además, el código de validación printTicket puede usar esta propiedad para redondear el valor de ParameterInit al valor más cercano indicado por Multiple. Nota: Los controladores de dispositivo y los proveedores PrintCapabilities no deben suponer que los valores ParameterInit son múltiplos de este valor property. Cada proveedor debe poder redondear valores arbitrarios al valor utilizable más cercano debido a la posibilidad de que distintos proveedores puedan especificar valores diferentes y en conflicto para esta propiedad.