1
0
mirror of https://github.com/php/doc-es.git synced 2026-04-28 01:23:14 +02:00
Files
archived-doc-es/reference/ps/functions/ps-set-info.xml
T
Pedro Antonio Gil Rodríguez 5760521d38 Correcciones menores
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@319579 c90b9560-bf6c-de11-be94-00142212c4b1
2011-11-20 11:19:47 +00:00

129 lines
4.4 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!-- splitted from ./en/functions/ps.xml, last change in rev 1.12 -->
<refentry xml:id="function.ps-set-info" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>ps_set_info</refname>
<refpurpose>Establecer los campos de información del documento</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>ps_set_info</methodname>
<methodparam><type>resource</type><parameter>p</parameter></methodparam>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><type>string</type><parameter>val</parameter></methodparam>
</methodsynopsis>
<para>
Establece ciertos campos de información del documento. Estos campos se mostrarán
como un comentario en la cabecera del fichero PostScript. Si el documento es
convertido a pdf, estos campos también se usarán para la información del
documento.
</para>
<para>
El campo <literal>BoundingBox</literal> normalmente se establece al valor dado a la
primera página. Esto sólo funciona si no se ha llamado antes a la función
<function>ps_findfont</function>. En tal caso BoundingBox estará sin establecer
a menos que se establezca explícitamente con esta función.
</para>
<para>
Esta función ya no tendrá efecto cuando la cabecera del fichero
postscript ha sido escrita. Debe ser llamada antes de la primera página
o de la primera llamada a la función <function>ps_findfont</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>psdoc</parameter></term>
<listitem>
<para>
Un identificador de recursos del fichero postscript,
como el devuelto por la función <function>ps_new</function>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
El nombre del campo de información a establecer. Los valores que se pueden
establecer son <literal>Keywords</literal> (palabras clave), <literal>Subject</literal> (asunto),
<literal>Title</literal> (título), <literal>Creator</literal> (creador),
<literal>Author</literal> (autor), <literal>BoundingBox</literal> (caja circundante), y
<literal>Orientation</literal> (orientación). Tenga en cuenta que algunos de ellos tienen un
significado para los visualizadoes de PostScript.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
El valor del campo de información. El campo
<literal>Orientation</literal> puede ser establecido a
<literal>Portrait</literal> (horizontal) o <literal>Landscape</literal> (vertical). El campo
<literal>BoundingBox</literal> es una cadena de caracteres que consiste en cuatro números.
Los dos primeros son las coordenadas de la esquina inferior izquierda de
la página. Los dos últimos son las coordenadas de la esquina
superior derecha.
</para>
<note>
<para>
Hasta la versión 0.2.6 de pslib, los campos BoundingBox y Orientation
eran sobrescritos por la función <function>ps_begin_page</function>,
a menos que se llamara antes a la función <function>ps_findfont</function>.
</para>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>ps_findfont</function></member>
<member><function>ps_begin_page</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->