PyQt개발강좌, 특정 키 입력으로 검색창 띄우기, 검색창에 QLineEdit로 텍스트 입력 필드 추가

안녕하세요, PyQt 개발에 관심이 있는 여러분! 이번 강좌에서는 특정 키 입력을 통해 검색창을 띄우고, 이 검색창에 QLineEdit 위젯을 추가하여 사용자가 텍스트를 입력할 수 있도록 만드는 방법에 대해 설명하겠습니다. 본 강좌를 통해 PyQt의 이벤트 처리 및 사용자 인터페이스 구축에 대한 이해를 높이고, 실용적인 프로젝트를 구성하는 데 도움이 되기를 바랍니다.

1. PyQt란?

PyQt는 파이썬 프로그래밍 언어를 위한 Qt 응용 프로그램 프레임워크의 바인딩입니다. Qt는 크로스 플랫폼 어플리케이션 개발을 위한 강력한 도구로, GUI 애플리케이션 구축에 매우 유용합니다. PyQt를 사용하면 파이썬으로 윈도우 애플리케이션을 쉽게 만들 수 있습니다. 본 강좌에서는 PyQt5를 기준으로 진행하겠습니다.

2. 필요한 패키지 설치하기

PyQt5를 사용하기 위해서는 먼저 관련 패키지를 설치해야 합니다. 다음의 pip 명령어를 사용하여 PyQt5를 설치하세요:

pip install PyQt5

3. 기본 창 만들기

PyQt5를 사용하여 기본적인 애플리케이션 창을 만들어보겠습니다. 이는 우리가 만들 검색창의 기반이 될 것입니다. 아래는 최소한의 PyQt5 애플리케이션을 생성하는 코드입니다.

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("검색창 예제")
        self.resize(400, 300)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

4. 특정 키 입력으로 검색창 띄우기

이제 다가올 타이밍을 기다리며 특정 키 (예: Ctrl+S)를 눌렀을 때 검색창이 나타나도록 설정해보겠습니다. 이를 위해 QMainWindow를 확장하면서 키 이벤트를 처리하는 메소드를 오버라이드합니다. 다음은 키 입력 이벤트를 처리하기 위한 코드입니다.

from PyQt5.QtWidgets import QLineEdit, QDialog, QVBoxLayout

class SearchDialog(QDialog):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("검색")
        self.layout = QVBoxLayout()

        # QLineEdit 추가
        self.line_edit = QLineEdit(self)
        self.layout.addWidget(self.line_edit)

        self.setLayout(self.layout)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("검색창 예제")
        self.resize(400, 300)

    def keyPressEvent(self, event):
        if event.key() == Qt.Key_Control and event.key() == Qt.Key_S:
            self.open_search_dialog()

    def open_search_dialog(self):
        self.search_dialog = SearchDialog()
        self.search_dialog.exec_()

5. 전체 코드 설명

이제 위에서 작성한 코드의 각 부분에 대해 자세히 설명하겠습니다.

  • SearchDialog 클래스: 이 클래스는 QDialog를 상속받아 검색창을 구현합니다. QVBoxLayout을 사용하여 QLineEdit 위젯을 담아 사용자로부터 텍스트 입력을 받습니다.
  • MainWindow 클래스: 이 클래스는 기본 창을 생성하며, keyPressEvent 메소드를 오버라이드하여 키 입력을 처리합니다. 사용자가 Ctrl 키와 S 키를 동시에 누르면 검색창이 열리도록 open_search_dialog 메소드를 호출합니다.
  • keyPressEvent 메소드: 이 메소드는 사용자가 키를 눌렀을 때 발생하는 이벤트를 처리합니다. 특정 조합의 키 입력을 감지하여 그에 맞는 행동을 설정할 수 있습니다.

6. 개선 사항: 검색창 모양 변경하기

기본적으로 제공되는 검색창을 조금 더 사용자 친화적으로 변경할 수 있습니다. 다음 코드를 사용하여 검색창의 속성을 조정할 수 있습니다:

self.line_edit.setPlaceholderText("검색어를 입력하세요...")
self.line_edit.setFixedWidth(300)

위 코드는 검색창에 플레이스홀더 텍스트를 추가하여 사용자가 어떤 정보를 입력해야 하는지 알 수 있도록 하고, 입력 창의 너비를 고정시킵니다.

7. 실시간 검색 결과 제공하기

검색 기능을 개선하기 위해 사용자가 입력하는 대로 실시간 검색 결과를 제공하는 기능을 추가할 수 있습니다. 아래 코드를 통해 이 기능을 구현할 수 있습니다

from PyQt5.QtCore import Qt

class SearchDialog(QDialog):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("검색")
        self.layout = QVBoxLayout()

        self.line_edit = QLineEdit(self)
        self.layout.addWidget(self.line_edit)

        self.result_label = QLabel("검색 결과:")
        self.layout.addWidget(self.result_label)

        self.line_edit.textChanged.connect(self.update_results)
        
        self.setLayout(self.layout)

    def update_results(self, text):
        # 여기에 텍스트에 대한 검색 로직을 추가하세요.
        filtered_results = [item for item in item_list if text.lower() in item.lower()]
        self.result_label.setText("\n".join(filtered_results))

이 코드는 사용자가 입력한 텍스트에 따라 필터링된 결과를 QLabel로 표시합니다.

8. 전체 코드: 최종 구현

이제 모든 구성 요소를 통합하여 최종 코드를 작성해 보겠습니다:

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QDialog, QVBoxLayout, QLineEdit, QLabel
from PyQt5.QtCore import Qt

# 예시 데이터
item_list = ["apple", "orange", "banana", "grape", "mango"]

class SearchDialog(QDialog):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("검색")
        self.layout = QVBoxLayout()

        self.line_edit = QLineEdit(self)
        self.line_edit.setPlaceholderText("검색어를 입력하세요...")
        self.layout.addWidget(self.line_edit)

        self.result_label = QLabel("검색 결과:")
        self.layout.addWidget(self.result_label)

        self.line_edit.textChanged.connect(self.update_results)
        
        self.setLayout(self.layout)

    def update_results(self, text):
        filtered_results = [item for item in item_list if text.lower() in item.lower()]
        self.result_label.setText("\n".join(filtered_results))

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("검색창 예제")
        self.resize(400, 300)

    def keyPressEvent(self, event):
        if event.key() == Qt.Key_Control and event.key() == Qt.Key_S:
            self.open_search_dialog()

    def open_search_dialog(self):
        self.search_dialog = SearchDialog()
        self.search_dialog.exec_()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

9. 추가 개선점

이번 강좌에서는 기본적인 검색창을 만드는 방법과 관련된 다양한 기능에 대해 알아보았습니다. 여기서 개선할 수 있는 점은 추가적인 디자인 요소를 포함시키거나, 여러 검색 옵션을 추가하는 것입니다. 또한 데이터베이스를 활용하여 더 많은 데이터를 검색할 수 있도록 기능까지 확장할 수 있습니다.

10. 마무리

이 강좌를 통해 PyQt의 기본 사용법을 배우고, 특정 키 입력으로 검색창을 띄우는 기능을 구현하는 법을 익혔습니다. 이번에 배운 내용을 바탕으로 자신만의 애플리케이션을 만들어 보시기 바랍니다. 앞으로도 다양한 PyQt 관련 강좌를 통해 더 심화된 내용을 다룰 예정입니다. 많은 관심 부탁드립니다!