<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Select a pen</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.printer-select-font.html">printer_select_font</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.printer-set-option.html">printer_set_option</a></div>
<div class="up"><a href="ref.printer.html">Printer Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.printer-select-pen" class="refentry">
<div class="refnamediv">
<h1 class="refname">printer_select_pen</h1>
<p class="verinfo">(PECL printer SVN)</p><p class="refpurpose"><span class="refname">printer_select_pen</span> — <span class="dc-title">Select a pen</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.printer-select-pen-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type"><span class="type void">void</span></span> <span class="methodname"><strong>printer_select_pen</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$printer_handle</code></span>
, <span class="methodparam"><span class="type">resource</span> <code class="parameter">$pen_handle</code></span>
)</div>
<p class="para rdfs-comment">
The function selects a pen as the active drawing object of the actual
device context. A pen is used to draw lines and curves. I.e. if you draw
a single line the pen is used. If you draw an rectangle the pen is used
to draw the borders, while the brush is used to fill the shape.
If you haven't selected a pen before drawing shapes, the shape won't be
outlined.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.printer-select-pen-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">printer_handle</code></em></span>
<dd>
<p class="para">
<em><code class="parameter">printer_handle</code></em> must be a valid printer handle.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">pen_handle</code></em></span>
<dd>
<p class="para">
<em><code class="parameter">pen_handle</code></em> must be a valid pen handle.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.printer-select-pen-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
No value is returned.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.printer-select-pen-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-5380">
<p><strong>Example #1 <span class="function"><strong>printer_select_pen()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$handle </span><span style="color: #007700">= </span><span style="color: #0000BB">printer_open</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">printer_start_doc</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">, </span><span style="color: #DD0000">"My Document"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">printer_start_page</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$pen </span><span style="color: #007700">= </span><span style="color: #0000BB">printer_create_pen</span><span style="color: #007700">(</span><span style="color: #0000BB">PRINTER_PEN_SOLID</span><span style="color: #007700">, </span><span style="color: #0000BB">30</span><span style="color: #007700">, </span><span style="color: #DD0000">"2222FF"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">printer_select_pen</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">, </span><span style="color: #0000BB">$pen</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">printer_draw_line</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">60</span><span style="color: #007700">, </span><span style="color: #0000BB">500</span><span style="color: #007700">, </span><span style="color: #0000BB">60</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">printer_delete_pen</span><span style="color: #007700">(</span><span style="color: #0000BB">$pen</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">printer_end_page</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">printer_end_doc</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">printer_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.printer-select-font.html">printer_select_font</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.printer-set-option.html">printer_set_option</a></div>
<div class="up"><a href="ref.printer.html">Printer Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
