Files
doc-fr/reference/w32api/reference.xml
Yannick Torres 57a608eaa6 sync with EN
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@179571 c90b9560-bf6c-de11-be94-00142212c4b1
2005-02-11 23:04:52 +00:00

138 lines
3.6 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- EN-Revision: 1.9 Maintainer: dams Status: partial -->
<reference id="ref.w32api">
<title>API windows</title>
<titleabbrev>W32api</titleabbrev>
<partintro>
<section id="w32api.intro">
&reftitle.intro;
<para>
Cette extension est une API générique d'accès aux DLL. Elle a été
originalement écrite pour accéder aux API Win32 depuis &php;, mais vous
pouvez l'utiliser pour accéder à d'autres fonctions exportées par des
DLL.
</para>
<para>
Actuellement, les types supportés sont les types &php; génériques
(chaînes de caractères, booléens, nombres, entiers et NULL), et les types
que vous définissez avec <function>w32api_deftype</function>.
</para>
<note>
<para>
&pecl.moved-ver;5.1.0.
</para>
</note>
&warn.experimental;
</section>
<section id="w32api.requirements">
&reftitle.required;
<para>
Cette extension ne fonctionne qu'avec le système Windows.
</para>
</section>
<section id="w32api.installation">
&reftitle.install;
&no.install;
</section>
<section id="w32api.configuration">
&reftitle.runtime;
&no.config;
</section>
<section id="w32api.resources">
&reftitle.resources;
<para>
Cette extension définit un type de ressource, utilisé pour les
types de données créé par l'utilisateur. Le nom de cette
ressource est <literal>"dynaparm"</literal>.
</para>
</section>
&reference.w32api.constants;
<section id="w32api.examples">
&reftitle.examples;
<para>
Cet exemple lit la durée de vie du système, et l'affiche dans une boîte :
</para>
<example>
<title>Lit la durée de vie de la machine, et l'affiche</title>
<programlisting role="php">
<![CDATA[
<?php
// Définit les constantes nécessaire, issues de
// Visual Studio/Tools/Winapi/WIN32API.txt
define("MB_OK", 0);
// Chargement de l'extension
dl("php_w32api.dll");
// Enregistrement de la fonction GetTickCount, provenant de kernel32.dll
w32api_register_function("kernel32.dll",
"GetTickCount",
"long");
// Enregistrement de la fonction MessageBoxA issue de User32.dll
w32api_register_function("User32.dll",
"MessageBoxA",
"long");
// Lecture de la durée de vie de la machine
$ticks = GetTickCount();
// Conversion en texte lisible
$secs = floor($ticks / 1000);
$mins = floor($secs / 60);
$hours = floor($mins / 60);
$str = sprintf("Vous utilisez cet ordinateur depuis : ".
"\r\n %d millisecondes, ou \r\n %d secondes".
"ou \r\n %d minutes ou\r\n %d heures %d minutes.",
$ticks,
$secs,
$mins,
$hours,
$mins - ($hours*60));
// Affiche le message dans une boîte de dialogue avec un bouton OK
MessageBoxA(NULL,
$str,
"Uptime Information",
MB_OK);
?>
]]>
</programlisting>
</example>
</section>
</partintro>
&reference.w32api.functions;
</reference>
<!-- 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:"../../../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
-->