winqueryreg can list subkey with argument "key"
[scilab.git] / scilab / modules / windows_tools / help / fr_FR / winqueryreg.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="winqueryreg">
3     <refnamediv>
4         <refname>winqueryreg</refname>
5         <refpurpose>Obtenir une clef de la base des
6             registres de Microsoft Windows
7         </refpurpose>
8     </refnamediv>
9     <refsynopsisdiv>
10         <title>Séquence d'appel</title>
11         <synopsis>
12             value = winqueryreg('name', 'rootkey', 'subkey')
13             value = winqueryreg('key', 'rootkey', 'subkey')
14             value = winqueryreg('rootkey', 'subkey', 'valname')
15             value = winqueryreg('rootkey', 'subkey')
16         </synopsis>
17     </refsynopsisdiv>
18     <refsection>
19         <title>Description</title>
20         <para>value = winqueryreg('name', 'rootkey', 'subkey') retourne les clefs
21             contenues dans rootkey\subkey dans une matrice de chaines de caracteres.
22             Le premier argument doit etre la chaine de caracteres, 'name'.
23         </para>
24         <para>Si la valeur contenue dans la base des registres est une chaine de
25             caracteres, winqueryreg retourne une chaine de caracteres. Si la valeur
26             est un entier sur 32 bits, winqueryreg retourne la valeur comme un entier
27             (int32).
28         </para>
29         <para>
30             value = winqueryreg('key', 'rootkey', 'subkey') retourne les sous clés
31             contenues dans rootkey\subkey dans une matrice de chaines de caracteres.
32             Le premier argument doit etre la chaine de caracteres, 'key'.
33         </para>
34         <para>value = winqueryreg('rootkey', 'subkey', 'valname') retourne la valeur
35             pour la clef valname dans rootkey\subkey.
36         </para>
37         <para>value = winqueryreg('rootkey', 'subkey') retourne la valeur "par
38             défaut" de la clef rootkey\subkey.
39         </para>
40         <para>
41             <literal>Note</literal>Les arguments 'name', 'key et 'rootkey' sont
42             "case-sensitive". Les arguments 'subkey' et 'valname' ne le sont pas.
43         </para>
44         <para>Les clefs racine supportées sont: 'HKEY_CLASSES_ROOT', 'HKEY_CURRENT_USER', 'HKEY_LOCAL_MACHINE', 'HKEY_USERS', 'HKEY_DYN_DATA' and 'HKEY_CURRENT_CONFIG'.</para>
45         <para>Leurs raccourcis peuvent aussi être utilisé 'HKCR', 'HKCU', 'HKLM', 'HKU', 'HKDD' and 'HKCC'</para>
46     </refsection>
47     <refsection>
48         <title>Exemples</title>
49         <programlisting role="example">
50             <![CDATA[
51 if getos() == 'Windows' then
52     winqueryreg 'HKEY_LOCAL_MACHINE' 'HARDWARE\DESCRIPTION\System\CentralProcessor\0\' 'ProcessorNameString'
53
54     mousechar = winqueryreg('name', 'HKEY_CURRENT_USER','control panel\mouse');
55     len=size(mousechar);
56     for k=1:len(1)
57         setting = winqueryreg('HKEY_CURRENT_USER','control panel\mouse', mousechar(k));
58         if (mousechar(k)=='') then mousechar(k)='default';,end
59         str = msprintf('%s = %s', mousechar(k), string(setting));
60         disp(str);
61     end
62
63     winqueryreg('HKEY_CURRENT_CONFIG', 'Software\Fonts\','LogPixels')
64     winqueryreg('key' ,'HKLM', 'Software\Microsoft\.NETFramework')
65 end
66  ]]>
67         </programlisting>
68     </refsection>
69     <refsection>
70         <title>History</title>
71         <revhistory>
72             <revision>
73                 <revnumber>5.4.0</revnumber>
74                 <revremark>Cette fonction gére également la clé 'HKEY_CURRENT_CONFIG'.</revremark>
75             </revision>
76             <revision>
77                 <revnumber>5.4.1</revnumber>
78                 <revremark>Accepte les raccourcis de clés racine.</revremark>
79                 <revremark>Peut renvoyer la liste des noms de clés.</revremark>
80             </revision>
81         </revhistory>
82     </refsection>
83 </refentry>