mirror of https://github.com/python/cpython
185 lines
6.6 KiB
Python
185 lines
6.6 KiB
Python
'''Define SearchDialogBase used by Search, Replace, and Grep dialogs.'''
|
|
|
|
from tkinter import (Toplevel, Frame, Entry, Label, Button,
|
|
Checkbutton, Radiobutton)
|
|
|
|
class SearchDialogBase:
|
|
'''Create most of a 3 or 4 row, 3 column search dialog.
|
|
|
|
The left and wide middle column contain:
|
|
1 or 2 labeled text entry lines (make_entry, create_entries);
|
|
a row of standard Checkbuttons (make_frame, create_option_buttons),
|
|
each of which corresponds to a search engine Variable;
|
|
a row of dialog-specific Check/Radiobuttons (create_other_buttons).
|
|
|
|
The narrow right column contains command buttons
|
|
(make_button, create_command_buttons).
|
|
These are bound to functions that execute the command.
|
|
|
|
Except for command buttons, this base class is not limited to
|
|
items common to all three subclasses. Rather, it is the Find dialog
|
|
minus the "Find Next" command and its execution function.
|
|
The other dialogs override methods to replace and add widgets.
|
|
'''
|
|
|
|
title = "Search Dialog" # replace in subclasses
|
|
icon = "Search"
|
|
needwrapbutton = 1 # not in Find in Files
|
|
|
|
def __init__(self, root, engine):
|
|
'''Initialize root, engine, and top attributes.
|
|
|
|
top (level widget): set in create_widgets() called from open().
|
|
text (Text being searched): set in open(), only used in subclasses().
|
|
ent (ry): created in make_entry() called from create_entry().
|
|
row (of grid): 0 in create_widgets(), +1 in make_entry/frame().
|
|
|
|
title (of dialog): class attribute, override in subclasses.
|
|
icon (of dialog): ditto, use unclear if cannot minimize dialog.
|
|
'''
|
|
self.root = root
|
|
self.engine = engine
|
|
self.top = None
|
|
|
|
def open(self, text, searchphrase=None):
|
|
"Make dialog visible on top of others and ready to use."
|
|
self.text = text
|
|
if not self.top:
|
|
self.create_widgets()
|
|
else:
|
|
self.top.deiconify()
|
|
self.top.tkraise()
|
|
if searchphrase:
|
|
self.ent.delete(0,"end")
|
|
self.ent.insert("end",searchphrase)
|
|
self.ent.focus_set()
|
|
self.ent.selection_range(0, "end")
|
|
self.ent.icursor(0)
|
|
self.top.grab_set()
|
|
|
|
def close(self, event=None):
|
|
"Put dialog away for later use."
|
|
if self.top:
|
|
self.top.grab_release()
|
|
self.top.withdraw()
|
|
|
|
def create_widgets(self):
|
|
'''Create basic 3 row x 3 col search (find) dialog.
|
|
|
|
Other dialogs override subsidiary create_x methods as needed.
|
|
Replace and Find-in-Files add another entry row.
|
|
'''
|
|
top = Toplevel(self.root)
|
|
top.bind("<Return>", self.default_command)
|
|
top.bind("<Escape>", self.close)
|
|
top.protocol("WM_DELETE_WINDOW", self.close)
|
|
top.wm_title(self.title)
|
|
top.wm_iconname(self.icon)
|
|
self.top = top
|
|
|
|
self.row = 0
|
|
self.top.grid_columnconfigure(0, pad=2, weight=0)
|
|
self.top.grid_columnconfigure(1, pad=2, minsize=100, weight=100)
|
|
|
|
self.create_entries() # row 0 (and maybe 1), cols 0, 1
|
|
self.create_option_buttons() # next row, cols 0, 1
|
|
self.create_other_buttons() # next row, cols 0, 1
|
|
self.create_command_buttons() # col 2, all rows
|
|
|
|
def make_entry(self, label, var):
|
|
"Return gridded labeled Entry."
|
|
l = Label(self.top, text=label)
|
|
l.grid(row=self.row, column=0, sticky="nw")
|
|
e = Entry(self.top, textvariable=var, exportselection=0)
|
|
e.grid(row=self.row, column=1, sticky="nwe")
|
|
self.row = self.row + 1
|
|
return e
|
|
|
|
def create_entries(self):
|
|
"Create one or more entry lines with make_entry."
|
|
self.ent = self.make_entry("Find:", self.engine.patvar)
|
|
|
|
def make_frame(self,labeltext=None):
|
|
"Return gridded labeled Frame for option or other buttons."
|
|
if labeltext:
|
|
l = Label(self.top, text=labeltext)
|
|
l.grid(row=self.row, column=0, sticky="nw")
|
|
f = Frame(self.top)
|
|
f.grid(row=self.row, column=1, columnspan=1, sticky="nwe")
|
|
self.row = self.row + 1
|
|
return f
|
|
|
|
def create_option_buttons(self):
|
|
"Fill frame with Checkbuttons bound to SearchEngine booleanvars."
|
|
f = self.make_frame("Options")
|
|
|
|
btn = Checkbutton(f, anchor="w",
|
|
variable=self.engine.revar,
|
|
text="Regular expression")
|
|
btn.pack(side="left", fill="both")
|
|
if self.engine.isre():
|
|
btn.select()
|
|
|
|
btn = Checkbutton(f, anchor="w",
|
|
variable=self.engine.casevar,
|
|
text="Match case")
|
|
btn.pack(side="left", fill="both")
|
|
if self.engine.iscase():
|
|
btn.select()
|
|
|
|
btn = Checkbutton(f, anchor="w",
|
|
variable=self.engine.wordvar,
|
|
text="Whole word")
|
|
btn.pack(side="left", fill="both")
|
|
if self.engine.isword():
|
|
btn.select()
|
|
|
|
if self.needwrapbutton:
|
|
btn = Checkbutton(f, anchor="w",
|
|
variable=self.engine.wrapvar,
|
|
text="Wrap around")
|
|
btn.pack(side="left", fill="both")
|
|
if self.engine.iswrap():
|
|
btn.select()
|
|
|
|
def create_other_buttons(self):
|
|
"Fill frame with buttons tied to other options."
|
|
f = self.make_frame("Direction")
|
|
|
|
btn = Radiobutton(f, anchor="w",
|
|
variable=self.engine.backvar, value=1,
|
|
text="Up")
|
|
btn.pack(side="left", fill="both")
|
|
if self.engine.isback():
|
|
btn.select()
|
|
|
|
btn = Radiobutton(f, anchor="w",
|
|
variable=self.engine.backvar, value=0,
|
|
text="Down")
|
|
btn.pack(side="left", fill="both")
|
|
if not self.engine.isback():
|
|
btn.select()
|
|
|
|
def make_button(self, label, command, isdef=0):
|
|
"Return command button gridded in command frame."
|
|
b = Button(self.buttonframe,
|
|
text=label, command=command,
|
|
default=isdef and "active" or "normal")
|
|
cols,rows=self.buttonframe.grid_size()
|
|
b.grid(pady=1,row=rows,column=0,sticky="ew")
|
|
self.buttonframe.grid(rowspan=rows+1)
|
|
return b
|
|
|
|
def create_command_buttons(self):
|
|
"Place buttons in vertical command frame gridded on right."
|
|
f = self.buttonframe = Frame(self.top)
|
|
f.grid(row=0,column=2,padx=2,pady=2,ipadx=2,ipady=2)
|
|
|
|
b = self.make_button("close", self.close)
|
|
b.lower()
|
|
|
|
if __name__ == '__main__':
|
|
import unittest
|
|
unittest.main(
|
|
'idlelib.idle_test.test_searchdialogbase', verbosity=2)
|