Created Advanced Usage Example (markdown)
parent
f96c352cb3
commit
6d8628defc
68
Advanced-Usage-Example.md
Normal file
68
Advanced-Usage-Example.md
Normal file
|
@ -0,0 +1,68 @@
|
|||
# Advanced Usage Examples
|
||||
## Customizing the Input Handler
|
||||
|
||||
The `DynamicCursesInput::InputHandler` class is highly customizable. You can create a subclass and override the handle_key method to add custom behavior for specific keys. For example:
|
||||
|
||||
```ruby
|
||||
class MyInputHandler < DynamicCursesInput::InputHandler
|
||||
private
|
||||
|
||||
def handle_key(chk)
|
||||
case chk
|
||||
when 'a'
|
||||
# Do something special when 'a' is pressed
|
||||
else
|
||||
super
|
||||
end
|
||||
end
|
||||
end
|
||||
```
|
||||
|
||||
Then, you can use `MyInputHandler` instead of `DynamicCursesInput::InputHandler:`
|
||||
|
||||
```ruby
|
||||
Curses.init_screen
|
||||
Curses.addstr("Enter your name: ")
|
||||
name = MyInputHandler.catch_input(true)
|
||||
Curses.addstr("\nYou entered: #{name}")
|
||||
Curses.getch
|
||||
Curses.close_screen
|
||||
```
|
||||
|
||||
## Using the Shorthand
|
||||
|
||||
The `DCI` shorthand can be used for easier access to the gem's functionality. For example:
|
||||
|
||||
```ruby
|
||||
|
||||
Curses.init_screen
|
||||
Curses.addstr("Enter your name: ")
|
||||
name = DCI.catch_input(true)
|
||||
Curses.addstr("\nYou entered: #{name}")
|
||||
Curses.getch
|
||||
Curses.close_screen
|
||||
```
|
||||
|
||||
## Handling Multiple Input Contexts
|
||||
|
||||
If your application has multiple input contexts (e.g., different screens or modes), you can create a separate `InputHandler` instance for each context. This allows you to customize the input handling behavior for each context.
|
||||
|
||||
```ruby
|
||||
class MainMenuInputHandler < DynamicCursesInput::InputHandler
|
||||
# Custom behavior for the main menu
|
||||
end
|
||||
|
||||
class GameInputHandler < DynamicCursesInput::InputHandler
|
||||
# Custom behavior for the game
|
||||
end
|
||||
```
|
||||
|
||||
Then, use the appropriate input handler depending on the current context:
|
||||
|
||||
```ruby
|
||||
input_handler = case current_context
|
||||
when :main_menu then MainMenuInputHandler
|
||||
when :game then GameInputHandler
|
||||
end
|
||||
input = input_handler.catch_input(true)
|
||||
```
|
Loading…
Reference in New Issue
Block a user