cvs: php-gtk-doc /manual/en/reference/gtk gtkcombobox.xml

http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/en/reference/gtk/gtkcombobox.xml?r1=1.23&r2=1.24&diff_format=u
Index: php-gtk-doc/manual/en/reference/gtk/gtkcombobox.xml
diff -u php-gtk-doc/manual/en/reference/gtk/gtkcombobox.xml:1.23 php-gtk-doc/manual/en/reference/gtk/gtkcombobox.xml:1.24
--- php-gtk-doc/manual/en/reference/gtk/gtkcombobox.xml:1.23	Mon Jul 30 22:52:49 2007
+++ php-gtk-doc/manual/en/reference/gtk/gtkcombobox.xml	Tue Jul 31 03:22:03 2007
@@ -1,41 +1,41 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1.22 Maintainer: dnfeitosa Status: ready -->
+<!-- $Revision: 1.24 $ --> 
 <classentry id="gtk.gtkcombobox">
  <classmeta>
   <classtitle>GtkComboBox</classtitle>
   <classparent>GtkBin</classparent>
     <implements>GtkCellLayout</implements>
-  <shortdesc>
-   Um widget usado para escolher de uma lista de items.
+<shortdesc>
+   A widget used to choose from a list of items.
   </shortdesc>
   <desc>
    <para>
-    O <classname>GtkComboBox</classname> é um substituto para os widgets 
-    <classname>GtkOptionMenu</classname> e <classname>GtkCombo</classname>,
-    provendo uma solução que permite ao usuário escolher de uma lista de 
-    opções.
+    The <classname>GtkComboBox</classname> is a replacement for the 
+    <classname>GtkOptionMenu</classname> and <classname>GtkCombo</classname>
+    widgets, providing a solution that allows the user to choose from a list of
+    options.
    </para>
    <para>
-    Um GtkComboBox implementa a interface <classname>GtkCellLayout</classname>,
-    que provê um número de metodos úteis para gerenciar o conteúdo, adotando
-    um padrão modelo-vista. O
-    <function class="GtkComboBox">constructor</function> pode ser associado com
-    um opcional <classname>GtkTreeModel</classname>, o qual pode, entretanto, 
-    ser adicionado posteriormente com o metodo
-    <function class="GtkComboBox">set_model</function>.
+    A GtkComboBox implements the <classname>GtkCellLayout</classname> interface,
+    that provides a number of useful methods for managing the contents, adopting
+    a model-view pattern. The 
+    <function class="GtkComboBox">constructor</function> can be associated with 
+    an optional <classname>GtkTreeModel</classname>, which can otherwise be 
+    added later with the <function class="GtkComboBox">set_model</function> 
+    method.
    </para>
    <para>
-    Alternativamente, a função <function class="GtkComboBox">new_text</function> 
-    cria um simples GtkComboBox e o modelo
-    <classname>GtkListStore</classname> associado. um 
-    <classname>GtkCellRendererText</classname> também é criado e empacotado na
-    nova caixa combo. Nesta caixa combo simples cada item da lista é uma string de texto que
-    pode ser selecionada. Os metodos de conveniencia
+    Alternatively, the <function class="GtkComboBox">new_text</function> 
+    function creates a simple GtkComboBox and associated
+    <classname>GtkListStore</classname> model. A 
+    <classname>GtkCellRendererText</classname> is also created and packed in the
+    new combo box. In this simple combo box each list item is a text string that
+    can be selected. The convenience methods
     <function class="GtkComboBox">append_text</function>,
     <function class="GtkComboBox">prepend_text</function>,
-    <function class="GtkComboBox">insert_text</function> e
-    <function class="GtkComboBox">remove_text</function> podem ser usado
-    para gerenciar os cnteúdos do GtkComboBox.
+    <function class="GtkComboBox">insert_text</function> and
+    <function class="GtkComboBox">remove_text</function> can be used
+    to manage the contents of the GtkComboBox.
    </para>
   </desc>
  </classmeta>
@@ -50,17 +50,17 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-    Cria um novo <classname>GtkComboBox</classname>
+    Creates a new <classname>GtkComboBox</classname>
    </shortdesc>
    <desc>
     <para>
-     Cria um novo <classname>GtkComboBox</classname> associado com um opcional
-     <classname>GtkTreeModel</classname> especificado por model.
-     Se model não for especificado a caixa combo não irá ter um tree model associado.
+        Creates a new <classname>GtkComboBox</classname> associated with the optional
+        <classname>GtkTreeModel</classname> specified by model.
+        If model is not specified the combo box will not have an associated tree model.
     </para>
     <para>
      <example>
-      <title>Criando um GtkComboBox</title>
+      <title>Creating a GtkLabel</title>
       <programlisting role="php">
        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="&directory.examples;/reference/gtk/gtkcombobox/constructor.phpw" parse="text">
         <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
@@ -79,22 +79,22 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-    Constroí uma nova caixa combo de texto
+    Constructs a new text combo box
    </shortdesc>
    <desc>
     <para>
-     A função <function class="GtkComboBox">new_text</function> é uma função de conveniencia que
-     constroí uma nova caixa combo de texto, a qual é um <classname>GtkComboBox</classname> apenas exibindo
-     strings. Se você usar esta função para criar uma nova caixa combo de texto, você deve apenas manipular
-     sua fonte de dados com os seguintes metos de conveniencia:
-     <function class="GtkComboBox">append_text</function>,
-     <function class="GtkComboBox">prepend_text</function>,
-     <function class="GtkComboBox">insert_text</function> e
-     <function class="GtkComboBox">remove_text</function>
+        The <function class="GtkComboBox">new_text</function> function is a convenience function that
+        constructs a new text combo box, which is a <classname>GtkComboBox</classname> just displaying
+        strings. If you use this function to create a text combo box, you should only manipulate
+        its data source with the following convenience methods:
+        <function class="GtkComboBox">append_text</function>,
+        <function class="GtkComboBox">prepend_text</function>,
+        <function class="GtkComboBox">insert_text</function> and
+        <function class="GtkComboBox">remove_text</function>
     </para>
     <para>
      <example>
-      <title>Criando um GtkComboBox de texto</title>
+      <title>Creating a Text GtkComboBox</title>
       <programlisting role="php">
        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="&directory.examples;/reference/gtk/gtkcombobox/new_text.phpw" parse="text">
         <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
@@ -119,14 +119,14 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-    Adiciona uma string expecificada por text a lista de strings.
+    Appends the string specified by text to the list of strings.
    </shortdesc>
    <desc>
     <para>
-     O metodo <function class="GtkComboBox">append_text</function> adiciona a string
-     especificada por texto na lista de strings guardadas na caixa combo
-     <classname>GtkListStore</classname>. Note que você só pode usar este metodo
-     com caixas combo construidas com a função <function class="GtkComboBox">new_text</function>.
+     The <function class="GtkComboBox">append_text</function> method appends the
+     string specified by text to the list of strings stored in the combo box
+     <classname>GtkListStore</classname>. Note that you can only use this method
+     with combo boxes constructed with the <function class="GtkComboBox">new_text</function> function.
     </para>
     <para>
      &seealso;
@@ -145,16 +145,16 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-    Retorna o índice no modeto do item atualmente ativo.
+    Returns the index in the model of the currently active item.
    </shortdesc>
    <desc>
     <para>
-     Retorna um inteiro o qual é o índice no modelo do item atualmente ativo, ou -1 se não houver item ativo.
+       Returns an integer which is the model index of the currently active item, or -1 if there's no active item.
     </para>
     <para>
-     O metodo <function class="GtkComboBox">get_active</function> retorna o valor
-     da propriedade "active" a qual é o índice no modelo do item
-     atualmente ativo, ou -1 se não houver item ativo.
+       The <function class="GtkComboBox">get_active</function> method returns the
+       value of the "active" property which is the index in the model of the
+       currently active item, or -1 if there's no active item.
     </para>
     <para>
      &seealso;
@@ -172,12 +172,12 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-    Retorna o item atual.
+        Returns the current item.
    </shortdesc>
    <desc>
     <para>
-     O metodo <function class="GtkComboBox">get_active_iter</function> retorna um <classname>GtkTreeIter</classname>
-     que aponta para o item ativo atual ou null se não houver item ativo.
+        The <function class="GtkComboBox">get_active_iter</function> method returns a <classname>GtkTreeIter</classname>
+        that points to the current active item or null if there is no active item
     </para>
     <para>
      &seealso;
@@ -195,14 +195,14 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-    Retorna a string atual
+       Returns the current string.
    </shortdesc>
    <desc>
     <para>
-     O metodo <function class="GtkComboBox">get_active_text</function> retorna a
-     string atualmente ativa ou null se nenhuma estiver selecionada.
-     Note que você pode usar esta função apenas com caixas combo construídas
-     com a função <function class="GtkComboBox">new_text</function>.
+        The <function class="GtkComboBox">get_active_text</function> method returns
+        the currently active string or null if no entry is selected.
+        Note that you can only use this function with combo boxes constructed
+        with the <function class="GtkComboBox">new_text</function> function.
     </para>
    </desc>
   </method>
@@ -215,7 +215,7 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-     Retorna o valor da propriedade "column-span-column".
+        Returns the value of the "column-span-column" property.
    </shortdesc>
    <desc>
     <para>
@@ -240,14 +240,14 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-     Retorna o valor da propriedade "focus-on-click".
+        Returns the value of the "focus-on-click" property.
    </shortdesc>
    <desc>
     <para>
-    <literal>Retorna</literal>: <literal>true</literal> se a caixa combo captura o foco quando é clicada com o mouse.
+    <literal>Returns </literal>: <literal>true</literal> if the combo box grabs focus when it is clicked with the mouse.
     </para>
     <para>
-     O metodo <function class="GtkComboBox">get_focus_on_click</function> retorna o valor da popriedade "focus-on-click".
+    The <function class="GtkComboBox">get_focus_on_click</function> method returns the value of the "focus-on-click" property.
     </para>
     <para>
      &seealso;
@@ -265,14 +265,14 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-     Retorna o valor da propriedade "model".
+        Returns the value of the "model" property.
    </shortdesc>
    <desc>
     <para>
-     O metodo <function class="GtkComboBox">get_model</function> retorna o valor da propriedade
-     "model" o qual contém o <classname>GtkTreeModel</classname> que esta ajindo
-     como fonte de dados para a caixa combo ou null se se não houver um <classname>GtkTreeModel</classname>
-     associado a caixa combo.
+    The <function class="GtkComboBox">get_model</function> method returns the value of
+    the "model" property which contains the <classname>GtkTreeModel</classname> that is
+    acting as data source for the combo_box or null if no <classname>GtkTreeModel</classname> is
+    associated with the combo box.
     </para>
     <para>
      &seealso;
@@ -290,14 +290,14 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-     Obtém o objeto correspondente ao popup.
+        Gets the object corresponding to the popup.
    </shortdesc>
    <desc>
     <para>
-     O metodo <function class="GtkComboBox">get_popup_accessible</function> obtém o objeto
-     de acessibilidade correspondente ao popup.
-     Este metodo é mais intencionado para o uso com tecnologias de acessibilidade;
-     aplicações terão pouco uso para ele.
+        The <function class="GtkComboBox">get_popup_accessible</function> method gets the
+        accessible object corresponding to the popup.
+        This method is mostly intended for use by accessibility technologies;
+        applications should have little use for it.
     </para>
 
    </desc>
@@ -338,14 +338,14 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-     Retorna o valor da propriedade "wrap-width".
+        Returns the value of the "wrap-width" property.
    </shortdesc>
    <desc>
     <para>
-     O metodo <function class="GtkComboBox">get_wrap_width</function> retorna o
-     valor da propriedade "wrap-width" da caixa combo como o definido pelo metodo <function class="GtkComboBox">set_wrap_width</function>.
-     O "wrap-width" é basicamente o número preferido de colunas para usar para posicionar o popup,
-     exemplo, posiciona os itens do popup em uma tabela com esta largura de colunas.
+        The <function class="GtkComboBox">get_wrap_width</function> method returns the
+        value of the "wrap-width" property of the combo box as set by the <function class="GtkComboBox">set_wrap_width</function>
+        method. The wrap width is basically the preferred number of columns to use to lay out the popup i.e.
+        lays out the popup items in a table with width columns.
     </para>
     <para>
      &seealso;
@@ -364,21 +364,21 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-    Insere uma string na caixa combo.
+    Inserts a string in the combo box.
    </shortdesc>
    <desc>
     <para>
-     <literal>position</literal>: Um índice do modelo aonde o texto deve ser inserido.
+        <literal>position</literal> : A model index where the text should be inserted.
     </para>
     <para>
-     <literal>text</literal>: Uma string.
+        <literal>text</literal> : A string.
     </para>
     
     <para>
-     O metodo <function class="GtkComboBox">insert_text</function> insere a string especificada por text
-     na caixa como <classname>GtkListStore</classname> no indice especificado por position.
-     Note que você só pode usar este metodo
-     com caixas combo construídas com a função <function class="GtkComboBox">new_text</function> function.
+        The <function class="GtkComboBox">insert_text</function> method inserts the string specified by text
+        in the combo box <classname>GtkListStore</classname> at the index specified by position.
+        Note that you can only use this
+        method with combo boxes constructed with the <function class="GtkComboBox">new_text</function> function.
     </para>
     <para>
      &seealso;
@@ -398,13 +398,13 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-     Esconde o menu ou a lista dropdown da caixa combo.
+        Hides the menu or dropdown list of the combo box.
    </shortdesc>
    <desc>
     <para>
-     O metodo <function class="GtkComboBox">popdown</function> esconde o menu ou a lista
-     dropdown da caixa combo. Este metodo é mais intencionado para uso com tecnologias
-     de acessibilidade; aplicações terão pouco uso para ele.
+        The <function class="GtkComboBox">popdown</function> method hides the menu or
+        dropdown list of the combo box. This method is mostly intended for use by accessibility
+        technologies; applications should have little use for it.
     </para>
    </desc>
   </method>
@@ -417,13 +417,13 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-     Mostra o menu ou lista dropdown.
+        Pops up the menu or dropdown list.
    </shortdesc>
    <desc>
     <para>
-     O metodo <function class="GtkComboBox">popup</function> mostra o menu ou lista dropdown
-     da caixa combo. Este metodo é mais intencionado para uso com tecnologias de
-     acessibilidade; aplicações terão pouco uso para ele.
+        The <function class="GtkComboBox">popup</function> method pops up the menu or dropdown list of
+        the combo box. This method is mostly intended for use by accessibility technologies;
+        applications should have little use for it.
     </para>
    </desc>
   </method>
@@ -436,18 +436,18 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-    Adiciona no início a string especificada por text na lista de strings.
+    Prepends the string specified by text to the list of strings.
    </shortdesc>
    <desc>
     <para>
-       <literal>text</literal>: Uma string.
+       <literal>text </literal>: A string.
     </para>
     <para>
-     O metodo <function class="GtkComboBox">prepend_text</function>
-     adiciona no início a string especificada por text na lista de strings salvas no
-     <classname>GtkListStore</classname> associada a caixa combo. Note
-     que você só pode usar este metodo com caixas combo construídas
-     com a função <function class="GtkComboBox">new_text</function>.
+        The <function class="GtkComboBox">prepend_text</function>
+        method prepends the string specified by text to the list of strings stored in the
+        <classname>GtkListStore</classname> associated with the combo_box. Note
+        that you can only use this method with combo boxes constructed with the
+        <function class="GtkComboBox">new_text</function> function.
     </para>
     <para>
      &seealso;
@@ -467,14 +467,14 @@
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-     Remove a string no índice.
+        Removes the string at the index.
    </shortdesc>
    <desc>
     <para>
-       <literal>position</literal>: ìndice do item a remover.
+       <literal>position </literal>: Index of the item to remove.
     </para>
     <para>
-    O metodo <function class="GtkComboBox">remove_text</function> method
+    The <function class="GtkComboBox">remove_text</function> method
     removes the string at the index specified by position in the associated 
     <classname>GtkListStore</classname>. Note that you can only use this function with combo
     boxes constructed with the <function class="GtkComboBox">new_text</function> function.