src/ftxui/dom/focus.cpp

Aller à la documentation de ce fichier.

// Copyright 2020 Arthur Sonzogni. Tous droits réservés.
// L'utilisation de ce code source est régie par la licence MIT que l'on peut trouver dans
// le fichier LICENSE.
#include <memory>   // for make_shared
#include <utility>  // for move
 
#include "ftxui/dom/elements.hpp"  // for Decorator, Element, focusPosition, focusPositionRelative
#include "ftxui/dom/node_decorator.hpp"  // for NodeDecorator
#include "ftxui/dom/requirement.hpp"  // for Requirement, Requirement::NORMAL, Requirement::Selection
#include "ftxui/screen/box.hpp"  // for Box
 
namespace ftxui {
 
/// @brief Utilisé à l'intérieur d'un `frame`, cela force la vue à être défilée vers une
/// position donnée. La position est exprimée en proportion de la taille demandée.
///
/// Par exemple:
/// - (0, 0) signifie que la vue est défilée vers le coin supérieur gauche.
/// - (1, 0) signifie que la vue est défilée vers le coin supérieur droit.
/// - (0, 1) signifie que la vue est défilée vers le coin inférieur gauche.
/// @ingroup dom
///
/// ### Exemple
///
/// ```cpp
/// Element document = huge_document()
///   | focusPositionRelative(0.f, 1.f)
///   | frame;
/// ```
Decorator focusPositionRelative(float x, float y) {
  class Impl : public NodeDecorator {
   public:
    Impl(Element child, float x, float y)
        : NodeDecorator(std::move(child)), x_(x), y_(y) {}
 
    void ComputeRequirement() override {
      NodeDecorator::ComputeRequirement();
      requirement_.focused.enabled = true;
      requirement_.focused.node = this;
      requirement_.focused.box.x_min = int(float(requirement_.min_x) * x_);
      requirement_.focused.box.y_min = int(float(requirement_.min_y) * y_);
      requirement_.focused.box.x_max = int(float(requirement_.min_x) * x_);
      requirement_.focused.box.y_max = int(float(requirement_.min_y) * y_);
    }
 
   private:
    const float x_;
    const float y_;
  };
 
  return [x, y](Element child) {
    return std::make_shared<Impl>(std::move(child), x, y);
  };
}
 
/// @brief Utilisé à l'intérieur d'un `frame`, cela force la vue à être défilée vers une
/// position donnée. La position est exprimée en nombre de cellules.
///
/// @ingroup dom
///
/// ### Exemple
///
/// ```cpp
/// Element document = huge_document()
///   | focusPosition(10, 10)
///   | frame;
/// ```
Decorator focusPosition(int x, int y) {
  class Impl : public NodeDecorator {
   public:
    Impl(Element child, int x, int y)
        : NodeDecorator(std::move(child)), x_(x), y_(y) {}
 
    void ComputeRequirement() override {
      NodeDecorator::ComputeRequirement();
      requirement_.focused.enabled = false;
 
      Box& box = requirement_.focused.box;
      box.x_min = x_;
      box.y_min = y_;
      box.x_max = x_;
      box.y_max = y_;
    }
 
   private:
    const int x_;
    const int y_;
  };
 
  return [x, y](Element child) {
    return std::make_shared<Impl>(std::move(child), x, y);
  };
}
 
}  // namespace ftxui