Máscara de formatação
30/01/2007 Leonardo Castilhos Thibes 
Neste meu primeiro artigo para a comunidade estou postando uma adaptação da classe Gtk2_EntryMask desenvolvida inicialmente pelo Pablo Dall'Oglio para formatação de campos entry.
A classe foi adaptada para uso em conjunto com o Glade, funcionalidade que antes não havia.
Agora é possível aplicar a funcionalidade de máscaras de formatação nos campos entry feitos no Glade, e não mais "na mão" como era o funcionamento anterior da classe.
É importante enfatizar que a classe foi desenvolvida pelo Pablo Dall'Oglio, eu apenas fiz uma adaptação das funcionalidades que já existiam.
Espero que aproveitem bem esta minha primeira contribuíção, que eu espero ser a primeira de muitas.
Leonardo C. Thibes
- XML DO GLADE
--------------------------------------------------------- <?xml version="1.0" standalone="no"?> <!--*- mode: xml -*--> <!DOCTYPE glade-interface SYSTEM "http://glade.gnome.org/glade-2.0.dtd"> <glade-interface> <widget class="GtkWindow" id="window1"> <property name="width_request">278</property> <property name="height_request">100</property> <property name="title" translatable="yes">Máscara de Formatação</property> <property name="type">GTK_WINDOW_TOPLEVEL</property> <property name="window_position">GTK_WIN_POS_NONE</property> <property name="modal">False</property> <property name="resizable">True</property> <property name="destroy_with_parent">False</property> <property name="decorated">True</property> <property name="skip_taskbar_hint">False</property> <property name="skip_pager_hint">False</property> <property name="type_hint">GDK_WINDOW_TYPE_HINT_NORMAL</property> <property name="gravity">GDK_GRAVITY_NORTH_WEST</property> <property name="focus_on_map">True</property> <property name="urgency_hint">False</property> <child> <widget class="GtkFixed" id="fixed1"> <property name="visible">True</property> <child> <widget class="GtkEntry" id="entry1"> <property name="width_request">160</property> <property name="height_request">27</property> <property name="visible">True</property> <property name="can_focus">True</property> <property name="editable">True</property> <property name="visibility">True</property> <property name="max_length">0</property> <property name="text" translatable="yes"></property> <property name="has_frame">True</property> <property name="invisible_char">•</property> <property name="activates_default">False</property> </widget> <packing> <property name="x">105</property> <property name="y">7</property> </packing> </child> <child> <widget class="GtkButton" id="button1"> <property name="width_request">55</property> <property name="height_request">29</property> <property name="visible">True</property> <property name="can_focus">True</property> <property name="label" translatable="yes">OK</property> <property name="use_underline">True</property> <property name="relief">GTK_RELIEF_NORMAL</property> <property name="focus_on_click">True</property> </widget> <packing> <property name="x">104</property> <property name="y">48</property> </packing> </child> <child> <widget class="GtkLabel" id="label1"> <property name="width_request">96</property> <property name="height_request">17</property> <property name="visible">True</property> <property name="label" translatable="yes">Máscara Padrão</property> <property name="use_underline">False</property> <property name="use_markup">False</property> <property name="justify">GTK_JUSTIFY_LEFT</property> <property name="wrap">False</property> <property name="selectable">False</property> <property name="xalign">0.5</property> <property name="yalign">0.5</property> <property name="xpad">0</property> <property name="ypad">0</property> <property name="ellipsize">PANGO_ELLIPSIZE_NONE</property> <property name="width_chars">-1</property> <property name="single_line_mode">False</property> <property name="angle">0</property> </widget> <packing> <property name="x">5</property> <property name="y">11</property> </packing> </child> </widget> </child> </widget> </glade-interface> --------------------------------------------------------- PHP QUE MONTA A TELA --------------------------------------------------------- <?php require_once('EntryMask.class.php'); class janela { public function __construct() { //Glade $this->glade = new GladeXML('masks.glade'); //EntryMask $this->EntryMask = new EntryMask(); //Window $this->win = $this->glade->get_widget('window1'); $this->win->connect('destroy',array($this,'close')); //Entry1 $this->entry1 = $this->glade->get_widget('entry1'); $this->EntryMask->setMask($this->entry1, '999.999.999-99'); //Button $this->button = $this->glade->get_widget('button1'); $this->button->connect('clicked', array($this, 'close')); //Show_all $this->win->show_all(); } public function close() { echo $this->entry1->get_text() . "\n"; gtk::main_quit(); } } new janela(); GTK::Main(); ?> --------------------------------------------------------- A CLASSE PROPRIAMENTE DITA --------------------------------------------------------- <?php /* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */ /** * GtkEntry with mask validation * * @category Gtk2 * @package Gtk2_EntryMask * @author Pablo Dall'Oglio <pablo@php.net> * @author Leonardo Castilhos Thibes <leonardothibes@yahoo.com.br> * @license LGPL * @version $Id: EntryMask.class.php,v 1.0 2007/01/30 11:37:43 leonardo Exp $ */ class EntryMask { /** * Characters used to format mask * @var array */ private $chars; /** * The Mask applied to the GtkEntry * @var string */ private $mask; /** * The GtkEntry object * @var $object */ private $object; /** * The Signal handler that is fired when the user types something * @var integer */ private $handler; /** * constructor. */ public function __construct() {} /** * Setando máscara. * * @param string $mask the allowed mask * @param object $object GtkEntry Object */ public function setMask($object, $mask) { /** Obtebdo objeto GtkEntry **/ $this->obj = $object; /** Obtendo máscara **/ $this->mask = $mask; /** Setando tamanho máximo do campo **/ $this->obj->set_max_length(strlen(trim($mask))); /** Array de separadores **/ $this->chars = array('-', '_', '.', ',', '/', '\\', ':', '|', '(', ')', '[', ']', '{', '}'); /** Conectando o sinal "changed" ao metodo onChange **/ $this->handler = $this->obj->connect('changed', array($this, 'onChange')); } /** * whenever the user types something the content is validated according to * the mask. */ public function onChange() { /** Setando o texto **/ $text = $this->obj->get_text(); /** Removendo separadores **/ $text = $this->unMask($text); /** Obtendo o tamanho do texto **/ $len = strlen(trim($text)); /** Aplicando a máscara **/ $new = $this->Mask($this->mask, $text); /** Agendando novo conteúdo **/ Gtk::timeout_add(1, array($this, 'Set'), $new); Gtk::timeout_add(1, array($this, 'Validate')); } /** * changes the Entry contents without fire "changed" signal * @param string $text the new text */ public function Set($text) { /** Desconectando o sinal "changed" do metodo "onChange" **/ $this->obj->disconnect($this->handler); /** Setando o texto do entry **/ $this->obj->set_text($text); /** Posicionando o cursor no final do texto **/ $this->obj->select_region(-1,-1); /** Conectando novamente o sinal "changed" no metodo "onChange" **/ $this->handler = $this->obj->connect_after('changed', array($this, 'onChange')); } /** * Validate the content of GtkEntry */ public function Validate() { /** Obtendo texto do objeto **/ $text = $this->obj->get_text(); /** Obtendo máscara **/ $mask = $this->mask; /** Obtendo tamanho do texto **/ $len = strlen($text); $text_char = substr($text, $len-1, 1); $mask_char = substr($mask, $len-1, 1); /** Comparando os caracteres digitados com a máscara **/ if ($mask_char == '9') $valid = ereg('([0-9])', $text_char); elseif ($mask_char == 'a') $valid = ereg('([a-z])', $text_char); elseif ($mask_char == 'A') $valid = ereg('([A-Z])', $text_char); elseif ($mask_char == 'X') $valid = (ereg('([a-z])', $text_char) or ereg('([A-Z])', $text_char) or ereg('([0-9])', $text_char)); /** Comparando os caracteres digitados com a máscara **/ /** Caracteres que não se aplicam no escopo da máscara são removidos **/ if (!$valid) { $this->Set(substr($text, 0, -1)); } } /** * put the typed content in the mask format * @param string $mask the mask * @param string $text the content */ public function Mask($mask, $text) { /** Run through the mask chars **/ $z = 0; for ($n=0; $n < strlen($mask); $n++) { $mask_char = substr($mask, $n, 1); $text_char = substr($text, $z, 1); /** Check when has to concatenate with the separator **/ if(in_array($mask_char, $this->chars)) { if($z < strlen($text)) { $result .= $mask_char; } } else { $result .= $text_char; $z++; } } return $result; } /** * removes the mask from text * @param string $text the content */ public function unMask($text) { /** Run through the content **/ for ($n=0; $n <= strlen($text); $n++) { $char = substr($text, $n, 1); /** Check if it's a separator **/ if (!in_array($char, $this->chars)) { $result .= $char; } } return $result; } } ?> --------------------------------------------------------- Crie sistemas de maneira ágil com PHP-GTK:
 |
Adianti Framework para PHP
|
Tenha mais produtividade com o PHP-GTK:
Adianti Studio: IDE para PHP
 |
|
