enum.html
来自「perl教程」· HTML 代码 · 共 140 行
HTML
140 行
<?xml version="1.0" ?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<!-- saved from url=(0017)http://localhost/ -->
<script language="JavaScript" src="../../../displayToc.js"></script>
<script language="JavaScript" src="../../../tocParas.js"></script>
<script language="JavaScript" src="../../../tocTab.js"></script>
<link rel="stylesheet" type="text/css" href="../../../scineplex.css">
<title>Win32::OLE::Enum - OLE Automation Collection Objects</title>
<link rel="stylesheet" href="../../../Active.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:" />
</head>
<body>
<script>writelinks('__top__',3);</script>
<h1><a>Win32::OLE::Enum - OLE Automation Collection Objects</a></h1>
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<ul>
<li><a href="#functions_methods">Functions/Methods</a></li>
</ul>
<li><a href="#authors_copyright">AUTHORS/COPYRIGHT</a></li>
</ul>
<!-- INDEX END -->
<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>Win32::OLE::Enum - OLE Automation Collection Objects</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<pre>
<span class="keyword">my</span> <span class="variable">$Sheets</span> <span class="operator">=</span> <span class="variable">$Excel</span><span class="operator">-></span><span class="variable">Workbooks</span><span class="operator">(</span><span class="number">1</span><span class="operator">)-></span><span class="variable">Worksheets</span><span class="operator">;</span>
<span class="keyword">my</span> <span class="variable">$Enum</span> <span class="operator">=</span> <span class="variable">Win32::OLE::Enum</span><span class="operator">-></span><span class="variable">new</span><span class="operator">(</span><span class="variable">$Sheets</span><span class="operator">);</span>
<span class="keyword">my</span> <span class="variable">@Sheets</span> <span class="operator">=</span> <span class="variable">$Enum</span><span class="operator">-></span><span class="variable">All</span><span class="operator">;</span>
</pre>
<pre>
<span class="keyword">while</span> <span class="operator">(</span><span class="keyword">defined</span><span class="operator">(</span><span class="keyword">my</span> <span class="variable">$Sheet</span> <span class="operator">=</span> <span class="variable">$Enum</span><span class="operator">-></span><span class="variable">Next</span><span class="operator">))</span> <span class="operator">{</span> <span class="operator">...</span> <span class="operator">}</span>
</pre>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>This module provides an interface to OLE collection objects from
Perl. It defines an enumerator object closely mirroring the
functionality of the IEnumVARIANT interface.</p>
<p>Please note that the <a href="#item_reset"><code>Reset()</code></a> method is not available in all implementations
of OLE collections (like Excel 7). In that case the Enum object is good
only for a single walk through of the collection.</p>
<p>
</p>
<h2><a name="functions_methods">Functions/Methods</a></h2>
<dl>
<dt><strong><a name="item_new">Win32::OLE::Enum-><code>new($object)</code></a></strong>
<dd>
<p>Creates an enumerator for $object, which must be a valid OLE collection
object. Note that correctly implemented collection objects must support
the <code>Count</code> and <code>Item</code> methods, so creating an enumerator is not always
necessary.</p>
</dd>
</li>
<dt><strong><a name="item_all">$Enum-><code>All()</code></a></strong>
<dd>
<p>Returns a list of all objects in the collection. You have to call
$Enum-><a href="#item_reset"><code>Reset()</code></a> before the enumerator can be used again. The previous
position in the collection is lost.</p>
</dd>
<dd>
<p>This method can also be called as a class method:</p>
</dd>
<dd>
<pre>
<span class="keyword">my</span> <span class="variable">@list</span> <span class="operator">=</span> <span class="variable">Win32::OLE::Enum</span><span class="operator">-></span><span class="variable">All</span><span class="operator">(</span><span class="variable">$Collection</span><span class="operator">);</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_clone">$Enum-><code>Clone()</code></a></strong>
<dd>
<p>Returns a clone of the enumerator maintaining the current position within
the collection (if possible). Note that the <a href="#item_clone"><code>Clone</code></a> method is often not
implemented. Use $Enum-><a href="#item_clone"><code>Clone()</code></a> in an eval block to avoid dying if you
are not sure that Clone is supported.</p>
</dd>
</li>
<dt><strong><a name="item_next">$Enum->Next( [$count] )</a></strong>
<dd>
<p>Returns the next element of the collection. In a list context the optional
$count argument specifies the number of objects to be returned. In a scalar
context only the last of at most $count retrieved objects is returned. The
default for $count is 1.</p>
</dd>
</li>
<dt><strong><a name="item_reset">$Enum-><code>Reset()</code></a></strong>
<dd>
<p>Resets the enumeration sequence to the beginning. There is no guarantee that
the exact same set of objects will be enumerated again (e.g. when enumerating
files in a directory). The methods return value indicates the success of the
operation. (Note that the <a href="#item_reset"><code>Reset()</code></a> method seems to be unimplemented in some
applications like Excel 7. Use it in an eval block to avoid dying.)</p>
</dd>
</li>
<dt><strong><a name="item_skip">$Enum->Skip( [$count] )</a></strong>
<dd>
<p>Skip the next $count elements of the enumeration. The default for $count is 1.
The functions returns TRUE if at least $count elements could be skipped. It
returns FALSE if not enough elements were left.</p>
</dd>
</li>
</dl>
<p>
</p>
<hr />
<h1><a name="authors_copyright">AUTHORS/COPYRIGHT</a></h1>
<p>This module is part of the Win32::OLE distribution.</p>
</body>
</html>
⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?