Esse é um tutorial que exige algum conhecimento de programação, da linguagem Python e do módulo PyGTK. Programadores experientes em outras linguagens provavelmente conseguirão entender e adaptar às suas necessidades. Caso queira aprender, existem tutoriais introdutórios de Python e PyGTK.Para quem programa interfaces em
PyGTK (ou GTK+ em outra linguagem, eu uso Python) aí vai uma dica de usabilidade:
Caso você tenha um campo de texto no seu programa, considere se não existe uma lista de valores comuns de preenchimento e dê uma ajudinha ao usuário a lembrar desses valores usando um
gtk.EntryCompletion. Usá-lo é muito simples:
entry = xml.get_widget('entry_verbo')
completion = gtk.EntryCompletion()
list_store = gtk.ListStore(gobject.TYPE_STRING)
list_store.append(('aqui',))
list_store.append(('botamos',))
list_store.append(('umas',))
list_store.append(('palavras',))
list_store.append(('para',))
list_store.append(('testar',))
completion.set_model(list_store)
completion.set_match_func(match_func)
completion.set_text_column(0)
entry.set_completion(completion)
Bom, a única coisa que falta no código acima é definir match_func que é uma função para buscar os valores de acordo com o que é digitado no
gtk.Entry. Ela deve ser uma função com a seguinte assinatura
def match_func(completion, key_string, iter, func_data):
onde completion é o próprio objeto
gtk.EntryCompletion usado pela função, key_string é a palavra que está no entry no momento da verificação, iter é um
gtk.TreeIter que aponta para um item da lista de dados da
gtk.EntryCompletion (uma
gtk.ListStore, no caso do exemplo acima) e func_data é um argumento adicional que pode ser passado no método
set_match_func do
gtk.EntryCompletion.
Essa função será executada para cada item do
gtk.ListStore e deve retornar True caso o item deva ser mostrado como opção de sugestão e False caso não deva. Na
documentação da PyGTK a seguinte função está disponível como exemplo:
def match_func(completion, key, iter, column):
model = completion.get_model()
text = model.get_value(iter, column)
if text.startswith(key):
return True
return False
Ela cobre um dos usos mais comuns de um completion, que é mostrar as palavras na lista cujo início seja igual à palavra digitada. Um exemplo é mostrado na imagem abaixo:
Férias terminando e no fim não cumpri minha pseudo-promessa (por isso era uma pseudo-promessa, eu sabia que não ia cumprir), MAS me diverti pacas. Sobre isso só posso mesmo é agradecer quem fez isso possível.
Primeiro à Le, minha namorada, claro. Além de namorada ela foi uma amiga muito divertida nessas férias e apesar das inevitáveis briguinhas ela contribuiu muito para a diversão das férias. Depois tem o Beck, o Félix e o Márcio (que eu cito em ordem alfabética pra ninguém se sentir menos importante, pra quem se sentir: teu cu), meus muito-mais-que-colegas, companheiros e amigos divertidíssimos a quem eu devo muitas risadas e descargas de endorfina.
Outros agradecimentos incluem o Pipi, por ser um dos inimigos mais legais de um jogo de videogame (além de ser responsável por uma das cenas mais embrulhantes de estômago de um filme de terror) e também à Heather, por ser uma protagonista de jogo com personalidade. Também gostaria de agradecer à Konami por fazer esses jogos legais e ao BitTorrent por... ahm, bem, deixa pra lá.
Ao jogar Silent Hill 2 tive a chance de me tornar mais íntimo do meu amiguinho o Pyramid Head, que carinhosamente chamamos de Pipi.
