cvs: php-gtk-doc /manual/pt_BR translation.xml /manual/pt_BR/reference/gtk gtkalignment.xml gtkdialog.xml gtkframe.xml

http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/pt_BR/translation.xml?r1=1.13&r2=1.14&diff_format=u
Index: php-gtk-doc/manual/pt_BR/translation.xml
diff -u php-gtk-doc/manual/pt_BR/translation.xml:1.13 php-gtk-doc/manual/pt_BR/translation.xml:1.14
--- php-gtk-doc/manual/pt_BR/translation.xml:1.13	Mon Jul 30 22:52:50 2007
+++ php-gtk-doc/manual/pt_BR/translation.xml	Thu Nov 15 13:42:03 2007
@@ -21,7 +21,7 @@
         person->nome de usuario do cvs, ou um apelido equivalente
         date->a data que começou, formato aaaa.mm.dd
     -->
-    <file name="GtkFrame,GtkHandleBox" person="fernandoc" type="translation" date="2007.04.07"/>
+    <file name="GtkHandleBox" person="fernandoc" type="translation" date="2007.04.07"/>
     <file name="gtklist*, gtkmenu*, gtkradio*" person="dnfeitosa" type="translation" date="2006.11.15"/>
    </work-in-progress>
 

http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/pt_BR/reference/gtk/gtkalignment.xml?view=markup&rev=1.1
Index: php-gtk-doc/manual/pt_BR/reference/gtk/gtkalignment.xml
+++ php-gtk-doc/manual/pt_BR/reference/gtk/gtkalignment.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.7 Maintainer: dnfeitosa Status: ready -->
<classentry id="gtk.gtkalignment">
 <classmeta>
  <classtitle>GtkAlignment</classtitle>
  <classparent>GtkBin</classparent>
  <shortdesc>
   Um container que controla o tamanho eo alinhamento do seu filho.
  </shortdesc>
  <desc>
   <para>
    O container <classname>GtkAlignment</classname> controla o alinhamento
    e o tamanho do seu filho, mrelativo as suas proprias dimensões. Entretanto, se o filho
    tem um tamanho requisitado de seu próprio filho/filhos, isso terá
    precedencia. Por exemplo, um <classname>GtkButton</classname> com um mrótulo
    nunca será redimencionado para um tamanho menos do que o do rótulo.
   </para>
   <para>
    Ele pode ser usado para definir o alinhamento relativo do filho 
    <emphasis>dentro</emphasis> do container, através dos parâmtros
    <parameter>xalign</parameter> e <parameter>yalign</parameter>.
    Ambos podem variar entra 0 e 1, significando esquerda/cima e direita/baixo respecitivamente.
    Isto é muito útil, por exemplo, em alinhar a esquerda ou direita um <classname>GtkLabel</classname>.
   </para>
   <para>
    Outro uso para <classname>GtkAlignment</classname> (através de
    <parameter>xscale</parameter> e <parameter>yscale</parameter>), é para
    indicar a quantidade de espaço extra livre no container que o filho deve ser
    extendido para ocupar. Note que isto não é o mesmo que o tamanho total do
    widget filho.
   </para>
   <para>
    <classname>GtkAlignment</classname> também prove metodos para especificamente
    definir (e obter o atual) o prenchimento em cima, baixo, direito e esquerda do widget.
   </para>
  </desc>
 </classmeta>

 <constructors>

  <constructor id="gtk.gtkalignment.constructor">
   <funcsynopsis>
    <funcprototype>
    <funcdef><function>GtkAlignment</function></funcdef>
    <paramdef>double <parameter><optional>xalign = 0.5</optional></parameter></paramdef>
    <paramdef>double <parameter><optional>yalign = 0.5</optional></parameter></paramdef>
    <paramdef>double <parameter><optional>xscale = 1.0</optional></parameter></paramdef>
    <paramdef>double <parameter><optional>yscale = 1.0</optional></parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Cria o container que controla o alinhamento e o tamanho do seu filho.
   </shortdesc>
   <desc>
    <para>
     <classname>GtkAlignment</classname> é um widget container que controla o
     alinhamento e o tamanho do seu filho.
    </para>
    <para>
     Um widget <classname>GtkAlignment</classname> tem quatro definições:
     <itemizedlist>
      <listitem><parameter>xalign</parameter>: Este parâmetro é usado para
      colocar horizontalmente o filho. Seu valor pode ser qualque coisa entre 0 (esquerda)
      e 1 (direita). O padrão é 0.5, o que centraliza o widget filho
      <emphasis>relativamente ao container<classname>GtkAlignment</classname> 
      </emphasis>.
      </listitem>
      <listitem><parameter>yalign</parameter>: Este parâmetro é usado para 
      colocar verticalmente o filho. O seu valor pode ser qualquer coisa entre 0 (cima)
      e 1 (baixo). O seu padrão é 0.5.
      </listitem>
      <listitem><parameter>xscale</parameter>: Define a quantidade de espaço horizontal
      livre no container <classname>GtkAlignment</classname>
      que o filho deve ser extendido para ocupar. 0 significa que o filho não irá
      extender, 1 significa que será extendido por todo o espaço livre disponível.
      </listitem>
      <listitem><parameter>yscale</parameter>: Define a quantidade de espaço vertical
      livre no container que o filho será extendido para ocupar. O intervalo é de 0 (o
      filho não será extendifo) até 1 (extendido para ocupar todo o espaço livre disponível).
      </listitem>
     </itemizedlist>
     <example>
      <title>Demostração do uso de GtkAlignment</title>
      <programlisting role="php">
       <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="&directory.examples;/reference/gtk/gtkalignment/constructor.phpw" parse="text">
        <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
       </xi:include>
      </programlisting>
     </example> 
    </para>
   </desc>
  </constructor>

 </constructors>

 <methods>

  <method id="gtk.gtkalignment.method.get_padding">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>get_padding</function></funcdef>
     <paramdef>void</paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Obtém o prenchimentos de lados diferentes do widget.
   </shortdesc>
   <desc>
    <para>
     Este metodo obtém o prenchimento atual nos diferentes lados do
     container <classname>GtkAlignment</classname>.
    </para>
    <para>
     &seealso;
     <function class="GtkAlignment">set_padding</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkalignment.method.set">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>set</function></funcdef>
     <paramdef>double <parameter>xalign</parameter></paramdef>
     <paramdef>double <parameter>yalign</parameter></paramdef>
     <paramdef>double <parameter>xscale</parameter></paramdef>
     <paramdef>double <parameter>yscale</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Define os novos valores para o <classname>GtkAlignment</classname>.
   </shortdesc>
   <desc>
    <para>
     Este metodo é usado para definir novos valores para
     um container <classname>GtkAlignment</classname>.
    </para>
   </desc>
  </method>

  <method id="gtk.gtkalignment.method.set_padding">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>set_padding</function></funcdef>
     <paramdef>int <parameter>padding_top</parameter></paramdef>
     <paramdef>int <parameter>padding_bottom</parameter></paramdef>
     <paramdef>int <parameter>padding_left</parameter></paramdef>
     <paramdef>int <parameter>padding_right</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Define o prenchimento dos diferentes lados do widget.
   </shortdesc>
   <desc>
    <para>
     Este metodo define o prenchimento dos diferentes lados do
     container <classname>GtkAlignment</classname>.
    </para>
    <para>
     &seealso;
     <function class="GtkAlignment">get_padding</function>
    </para>

   </desc>
  </method>

 </methods>

</classentry>

http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/pt_BR/reference/gtk/gtkdialog.xml?view=markup&rev=1.1
Index: php-gtk-doc/manual/pt_BR/reference/gtk/gtkdialog.xml
+++ php-gtk-doc/manual/pt_BR/reference/gtk/gtkdialog.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.14 Maintainer: fernandoc Status: ready -->
<classentry id="gtk.gtkdialog">
 <classmeta>
  <classtitle>GtkDialog</classtitle>
  <classparent>GtkWindow</classparent>
  <classimage fileref="&directory.images;/reference/gtk/gtkdialog.png"/>
  <shortdesc>
   Uma janela popup.
  </shortdesc>
  <desc>
   <para>
    Como o nome sugere, <classname>GtkDialog</classname> é um widget que
    é útil quando você quer interagir com o usuário. Por exemplo,
    você pode querer perguntar uma questão ao usuário, pedir alguma entrada, ou
    confirmar alguma ação. O <classname>GtkDialog</classname> ajuda em casos
    assim provendo uma janela adequada para interação. Não seja enganado
    pelo exemplo simples, um <classname>GtkDialog</classname> pode fazer
    muito mais coisas do que é mostrado!
   </para>
   <para>
    Um <classname>GtkDialog</classname> é basicamente feito de duas
    areas principais, a area de cima, aonde você empacota widgets como
    <classname>GtkLabel</classname> ou um <classname>GtkEntry</classname>.
    A area de baixo deve ser usada para exibir
    <classname>GtkButton</classname>s que irão realizar alguma ação, como
    OK ou cancelar. A area de baixo do dialogo é conhecida como
    <fieldname class="GtkDialog">action_area</fieldname>, enquanto a area de cima
    é um <fieldname class="GtkDialog">vbox</fieldname>.
   </para>
   <para>
    O procedimento geral para criar uma caixa de dialogo seria criar
    uma caixa de dialogo com o seu construtor e então adicionar os widgets apropriados
    ao <fieldname class="GtkDialog">vbox</fieldname> e
    <fieldname class="GtkDialog">action_area</fieldname>. Alternativamente,
    ao invés de adicionar os botões necessários ao 
    <fieldname class="GtkDialog">action_area</fieldname>, você pode fazer uso do 
    metodo <function class="GtkDialog">add_button</function>. A vantagem
    deste metodo é que você obtém um sinal de resposta da escolha.
    Você pode escolher um ID do sinal de resposta de <enumname>GtkResponseType</enumname>,
    que seja adequado ao significado do seu botão. A terceira e mais 
    conveniente maneira de adicionar botões ao dialogo é passa-los como parâmetros
    ao usar o contrutor.
   </para>
   <note>
    A maioria das vezes, entretanto, você não tem que passar por todo este problema
    a menos que você queira criar um dialogo altamente personalizado. Os
    tipos comuns de caixa de dialogo tem widgets por sí, como o
    <classname>GtkFileChooserDialog</classname> ou o
    <classname>GtkColorSelectionDialog</classname>.
   </note>
  </desc>
 </classmeta>

 <constructors>

  <constructor id="gtk.gtkdialog.constructor">
   <funcsynopsis>
    <funcprototype>
    <funcdef> <function>GtkDialog</function></funcdef>
    <paramdef>string <parameter><optional>title = null</optional></parameter></paramdef>
    <paramdef>GtkWidget <parameter><optional>parent_window = null</optional></parameter></paramdef>
    <paramdef><enumname>GtkDialogFlags</enumname> <parameter><optional>dialog_flags = 0</optional></parameter></paramdef>
    <paramdef>array <parameter><optional>(GtkButton,
    <enumname>GtkResponseType</enumname>)</optional></parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Cria uma nova caixa de dialogo.
   </shortdesc>
   <desc>
    <para>
     Use o construtor para gerar uma caixa de dialogo de acordo com os
     parãmetros providos. Alternativamente, você pode não passar qualquer parâmetro
     e construir todos os elementos do dialogo manualmente.
    </para>
    <example>
     <title>Uma reconstrução de GtkMessageDialog usando GtkDialog.</title>
     <programlisting role="php">
       <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="&directory.examples;/reference/gtk/gtkdialog/constructor.phpw" parse="text">
       <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
      </xi:include>
     </programlisting>
    </example>
   </desc>
  </constructor>
 </constructors>

 <methods>

  <method id="gtk.gtkdialog.method.add_action_widget">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>add_action_widget</function></funcdef>
     <paramdef>GtkWidget <parameter>child</parameter></paramdef>
     <paramdef>int <parameter>response_id</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Adiciona um widget ao <literal>action_area</literal>
   </shortdesc>
   <desc>
    <para>
     Use este metodo para adicionar um widget que pode ser ativado no
     <literal>action_area</literal> do dialogo. O ID de resposta a ser
     gerado quando o widget é ativado é passado como parâmetro para o
     metodo. O widget é adicionado ao fim da area de ação do dialogo.
    </para>
    <note>
     Apenas widgets <literal>ativáveis</literal> podem ser adicionados usando este
     metodo. Para adicionar um widget não-ativável, use o metodo add na
     propriedade <literal>action_area</literal> do
     <classname>GtkDialog</classname>.
    </note>
   </desc>
  </method>

  <method id="gtk.gtkdialog.method.add_button">
   <funcsynopsis>
    <funcprototype>
     <funcdef>GtkWidget <function>add_button</function></funcdef>
     <paramdef>string <parameter>button_text</parameter></paramdef>
     <paramdef>int <parameter>response_id</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Adiciona um botão ao dialogo.
   </shortdesc>
   <desc>
    <para>
     Você pode usar este metodo para manualmente adicionar um botão para a
     propriedade <literal>action_area</literal> do dialogo. Claro, você
     pode também adicionar botões após você ter chamado o construtor com
     botões. Você pode adicionar um botão personalizado ou um item do estoque, dependendo
     quando você passa um stock-ID ou texto plano como um parâmetro string. O
     sinal de resposta também pode ser indicado como dado em 
     <enumname>GtkResponseType</enumname>.
    </para>
    <para>
     O botão criado é retornado como um widget por este metodo, mas na
     maioria você não vai precisar usa-lo.
    </para>
   </desc>
  </method>

  <method id="gtk.gtkdialog.method.add_buttons">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>add_buttons</function></funcdef>
     <paramdef>array <parameter>buttons</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Adiciona um array de botões ao dialogo.
   </shortdesc>
   <desc>
    <para>
     Adiciona um array de botões ao
     <propname class="GtkDialog">action_area</propname> do dialogo.
     <parameter>buttons</parameter> deve ser um array contendo pares de
     rótulos de botões e respostas de dialogo. 
    </para>
    <para>
     Chamar <function class="GtkDialog">add_buttons</function> é similar a
     chamar <function class="GtkDialog">add_button</function> many times.
    </para>
    <para>
     &seealso;
     <function class="GtkDialog">add_button</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkdialog.method.get_has_separator">
   <funcsynopsis>
    <funcprototype>
     <funcdef>bool <function>get_has_separator</function></funcdef>
     <paramdef>void</paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Retorna se o dialogo tem um separador.
   </shortdesc>
   <desc>
    <para>
     Você deve usar esta função para determinar se a caixa de dialogo contém
     um separador (entre as propriedades <literal>vbox</literal> e
     <literal>action_area</literal>). A função retorna
     <literal>true</literal> se tiver, <literal>false</literal>
     se não.
    </para>
    <para>
     &seealso;
     <function class="GtkDialog">set_has_separator</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkdialog.method.response">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>response</function></funcdef>
     <paramdef>int <parameter>response_id</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Emite o sinal de resposta.
   </shortdesc>
   <desc>
    <para>
     Este metodo emite o sinal de resposta do dialogo. O sinal de
     resposta será do tipo especificado por response ID que é passado
     como um parâmetro.
    </para>
   </desc>
  </method>

  <method id="gtk.gtkdialog.method.run">
   <funcsynopsis>
    <funcprototype>
     <funcdef>int <function>run</function></funcdef>
     <paramdef>void</paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Bloqueia o loop principal até que o dialogo seja destruído.
   </shortdesc>
   <desc>
    <para>
     Este é o metodo que perite a você analizar a resposta gerada
     pelo dialogo. Quando você chama este metodo em um 
     <classname>GtkDialog</classname>, o loop principal do GTK é bloqueado
     até que o dialogo seja ou destruído ou emita um sinal de resposta.
    </para>
    <para>
     O dialogo é também automaticamente definido como tipo modal, e o metodo
     show também é chamado automaticamente. Entretanto, você precisa exibir
     quaisquer widgets filhos por sí.
    </para>
    <para>
     É altamente recomendado gerar um sinal de resposta para sair
     da execução do loop. Se você destruir o dialogo enquanto o loop esta sendo executado,
     então o seu código para depois da execução não saberá se o dialogo foi
     destruído ou não.
    </para>
    <para>
     A função irá retorna um id de resposta assim que um for gerado e saíra.
     Note que você precisa destruir o dialogo manualmente quando
     tiver processado a resposta.
    </para>
   </desc>
  </method>

  

  

  <method id="gtk.gtkdialog.method.set_default_response">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>set_default_response</function></funcdef>
     <paramdef>int <parameter>response_id</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Define o ID de resposta a ser gerado pelo dialogo.
   </shortdesc>
   <desc>
    <para>
     Esta função é usada para definir um ID de resposta gerado pelo widget
     que foi adicionado por último no <literal>action_area</literal>. O último
     widget é normalmente o widget padrão para o dialogo, e será ativado
     quando a tecla enter for pressionada. O ID de resposta é passado como
     parâmetro para o metodo.
    </para>
   </desc>
  </method>

  <method id="gtk.gtkdialog.method.set_has_separator">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>set_has_separator</function></funcdef>
     <paramdef>bool <parameter>setting</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Define quando o dialogo tem um separador.
   </shortdesc>
   <desc>
    <para>
     Você deve usar este metodo para definir quando o <literal>vbox</literal> e
     <literal>action_area</literal> são separados por um (usualmente horizontal)
     separador. Passe <literal>true</literal> como um parâmetro se você quer que o
     separador esteja presente, <literal>false</literal> se não.
    </para>
    <para>
     A definição é <literal>true</literal> por padrão.
    </para>
    <para>
     &seealso;
     <function class="GtkDialog">get_has_separator</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkdialog.method.set_response_sensitive">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>set_response_sensitive</function></funcdef>
     <paramdef>int <parameter>response_id</parameter></paramdef>
     <paramdef>bool <parameter>setting</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Define os widgets ativáveis para ser sensíveis ou não.
   </shortdesc>
   <desc>
    <para>
     Você pode usar esta função para convenientemente tornar sensível ou não
     os botões do dialogo presente no <literal>action_area</literal>. Esta função
     chama <function classname="GtkWidget">set_sensitive</function> on cada
     widget presente no <literal>action_area</literal> com o
     ID de resposta (passado como parâmetro). A definição pode ser
     <literal>true</literal> ou <literal>false</literal> dependendo se
     você quer que os botões correspondentes sejam sensíveis ou não.
    </para>
   </desc>
  </method>

 </methods>

 <fields>

  <field id="gtk.gtkdialog.field.action_area" type="ro">
   <fieldname>action_area</fieldname>
   <fieldtype>GtkWidget</fieldtype>
   <shortdesc>
    Descreve a area do dialogo que guarda os widgets de ação
    (botões).
   </shortdesc>
   <desc>
   </desc>
  </field>

  <field id="gtk.gtkdialog.field.vbox" type="ro">
   <fieldname>vbox</fieldname>
   <fieldtype>GtkWidget</fieldtype>
   <shortdesc>
    Descreve a area do dialogo que guarda os widgets de perguntas
    (rótulos).
   </shortdesc>
   <desc>
   </desc>
  </field>

 </fields>

 <signals>

  <signal id="gtk.gtkdialog.signal.close">
   <signalname>close</signalname>
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <cbfunction>callback</cbfunction></funcdef>
     <paramdef>GtkDialog <parameter>dialog</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Emitido quando o dialogo é destruído.
   </shortdesc>
   <desc>

   </desc>
  </signal>
  
  <signal id="gtk.gtkdialog.signal.response">
   <signalname>response</signalname>
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <cbfunction>callback</cbfunction></funcdef>
     <paramdef>GtkDialog <parameter>dialog</parameter></paramdef>
     <paramdef>int <parameter>UNKNOWN</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Emitido quando um widget de ação(botão) é clicado.
   </shortdesc>
   <desc>
   </desc>
  </signal>
  
 </signals>

</classentry>

http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/pt_BR/reference/gtk/gtkframe.xml?view=markup&rev=1.1
Index: php-gtk-doc/manual/pt_BR/reference/gtk/gtkframe.xml
+++ php-gtk-doc/manual/pt_BR/reference/gtk/gtkframe.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.8 Maintainer: fernandoc Status: ready -->
<classentry id="gtk.gtkframe">
 <classmeta>
  <classtitle>GtkFrame</classtitle>
  <classparent>GtkBin</classparent>
  <classimage fileref="&directory.images;/reference/gtk/gtkframe.png"/>
  <shortdesc>
   Uma moldura decorativa para guardar um widget.
  </shortdesc>
  <desc>
   <para>
    Um <classname>GtkFrame</classname> é essencialmente um
    <classname>GtkBin</classname> com uma borda decorativa e um
    rótulo opcional. É na maioria usado para conter seus widgets em
    uma aplicação em uma maneira organizada e atraente.
   </para>
   <para>
    Se um rótulo é especificado, ele irá aparecer em uma brecha no topo
    da moldura. A posição do rótulo pode ser especificada com 
    <function class="GtkFrame">set_label_align</function>.
   </para>
   <para>
    Uma coisa importante para notar é que, desde que 
    <classname>GtkFrame</classname> é derivado de 
    <classname>GtkBin</classname>, ele pode conter apenas um widget filho!
   </para>
  </desc>
 </classmeta>

 <constructors>

  <constructor id="gtk.gtkframe.constructor">
   <funcsynopsis>
    <funcprototype>
    <funcdef> <function>GtkFrame</function></funcdef>
    <paramdef>string <parameter><optional>label = null</optional></parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Cria uma nova moldura opcionalmente com um rotulo.
   </shortdesc>
   <desc>
    <para>
     Use o construtor para criar uma nova moldura, Você pode também especificar o
     rótulo que será exibido no topo da moldura como um argumento para a função.
     Alternativamente, você pode usar
     <function class="GtkFrame">set_label_widget</function>, ou
     <function class="GtkFrame">set_label</function> para adicionar um rótulo
     a moldura depois que ela já tiver sido criada.
    </para>
   </desc>
  </constructor>

 </constructors>

 <methods>

  <method id="gtk.gtkframe.method.get_label">
   <funcsynopsis>
    <funcprototype>
     <funcdef>string <function>get_label</function></funcdef>
     <paramdef>void</paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Retorna o rótulo definido para a moldura.
   </shortdesc>
   <desc>
    <para>
     Use este metodo para determinar o rótulo que esta atualmente definido
     para a moldura. O texto do rótulo será retornado,
     <literal>null</literal> se não tiver sido definido um rótulo para a moldura ou
     se o widget do rótulo não for do tipo <classname>GtkLabel</classname>.
    </para>
    <para>
     &seealso;
     <function class="GtkFrame">set_label</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkframe.method.get_label_align">
   <funcsynopsis>
    <funcprototype>
     <funcdef>array <function>get_label_align</function></funcdef>
     <paramdef>void</paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Obtém o alinhamento X e Y do rótulo do frame.
   </shortdesc>
   <desc>
    <para>
     Obtém o alinhamento X e Y do rótulo do frame.
    </para>
    <para>
     &seealso;
     <function class="GtkFrame">set_label_align</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkframe.method.get_label_widget">
   <funcsynopsis>
    <funcprototype>
     <funcdef>GtkWidget <function>get_label_widget</function></funcdef>
     <paramdef>void</paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Retorna o widget do rótulo da moldura.
   </shortdesc>
   <desc>
    <para>
     Use este metodo para obter o widget do rótulo da moldura. A função irá sempre
     retornar um objeto <classname>GtkLabel</classname>, a menos que
     não tenha sido definido um rótulo, caso no qual <literal>null</literal> será retornado.
    </para>
    <para>
     &seealso;
     <function class="GtkFrame">set_label_widget</function>
    </para>

   </desc>
  </method>

  <method id="gtk.gtkframe.method.get_shadow_type">
   <funcsynopsis>
    <funcprototype>
     <funcdef>GtkShadowType <function>get_shadow_type</function></funcdef>
     <paramdef>void</paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Retorna o tipo de sombra da moldura.
   </shortdesc>
   <desc>
    <para>
     Use este metodo para obter o tipo de sombra da moldura. A função irá
     retornar uma constante GtkShadowType.
    </para>
    <para>
     &seealso;
     <function class="GtkFrame">set_shadow_type</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkframe.method.set_label">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>set_label</function></funcdef>
     <paramdef>string <parameter>label</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Define o rótulo atual para a moldura.
   </shortdesc>
   <desc>
    <para>
     Use este metodo para definir o rótulo atual para a moldura. Você deve 
     passar uma string como parâmetro para definir este texto como rótulo.
    </para>
    <para>
     &seealso;
     <function class="GtkFrame">get_label</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkframe.method.set_label_align">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>set_label_align</function></funcdef>
     <paramdef>double <parameter>xalign</parameter></paramdef>
     <paramdef>double <parameter>yalign</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Define o alinhamento do rótulo da moldura.
   </shortdesc>
   <desc>
    <para>
     Este metodo pode ser usado para controlar o alinhamento do rótulo da moldura.
     Dois parâmetros são passados para a função, ambos são números variando
     de 0 a 1. <literal>xalign</literal> determina o alinhamento horizontal
     do rótulo (0 significa o canto mais à esquerda) e
     <literal>yalign</literal> determina o alinhamento vertical (0 aqui, implica
     que o rótulo irá aparecer no topo superior da moldura).
    </para>
    <para>
     &seealso;
     <function class="GtkFrame">get_label_align</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkframe.method.set_label_widget">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>set_label_widget</function></funcdef>
     <paramdef>GtkWidget <parameter>label_widget</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
    Define o rótulo do frame.
   </shortdesc>
   <desc>
    <para>
     Se você quiser passar um <classname>GtkLabel</classname> para ser o rótulo
     da moldura, use este metodo.
     <function class="GtkFrame">set_label</function> irá apenas permitir
     uma string como o seu parâmetro e esta função ira apenas permitir
     <classname>GtkLabel</classname>s.
    </para>
    <para>
     &seealso;
     <function class="GtkFrame">get_label_widget</function>
    </para>
   </desc>
  </method>

  <method id="gtk.gtkframe.method.set_shadow_type">
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>set_shadow_type</function></funcdef>
     <paramdef><enumname>GtkShadowType</enumname> <parameter>type</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <shortdesc>
     Define o tipo de sombra da moldura.
   </shortdesc>
   <desc>
    <para>
     Você pode usar esta função para definir o tipo de sombra da borda da moldura.
     0 como parâmetro irá resultar em uma moldura sem borda, enquanto 3
     irá dar a você uma borda entalhada.
    </para>
    <para>
     &seealso;
     <function class="GtkFrame">get_shadow_type</function>
    </para>
   </desc>
  </method>

 </methods>

</classentry>