关于 LGFX_Button

这个库的设计兼容 Adafruit GFX Library .虚拟的按键可以被放置在屏幕,以便于控制.

用法

LGFX_Button button();

定义并使用LGFX_Button.

案例程序:

#include <Arduino.h>
#include <M5GFX.h>
#include <M5Unified.h>

static int32_t w;
static int32_t h;

LGFX_Button button;

void setup(void) {
    auto cfg = M5.config();
    M5.begin(cfg);
    w = M5.Lcd.width();
    h = M5.Lcd.height();
    button.initButton(&M5.Lcd, w / 2, h / 2, 100, 50, TFT_RED, TFT_YELLOW,
                      TFT_BLACK, "Btn");
    button.drawButton();
}

void loop(void) {
    M5.update();
    if (M5.BtnA.isPressed()) {
        button.press(true);
        button.drawButton(true);
        M5.Lcd.drawString("Button Pressed ", 0, 0, &fonts::lgfxJapanGothic_16);
        Serial.println("Pressed");
    } else {
        button.press(false);
        button.drawButton(false, "Test");
        M5.Lcd.drawString("Button Released", 0, 0, &fonts::lgfxJapanGothic_16);
        Serial.println("Released");
    }
    delay(50);
}

API

contains()

确定指定的坐标是否包含在按钮位置中,用于确定按钮是否在触摸面板上被按下。

函数原型:

bool contains(int16_t x, int16_t y)

drawButton()

绘制一个按键,如果倒置参数被设置为 "true"，则背景色被反转。

函数原型:

void drawButton(bool inverted = false, const char* long_name = nullptr)

initButton

初始化按键.

void initButton(M5GFX *gfx, int16_t x, int16_t y, int16_t w, int16_t h, const T& outline, const T& fill, const T& textcolor, const char* label, float textsize_x = 1.0f, float textsize_y = 1.0f)

*1. 关于字体代码

isPressed()

返回由 press() 设置的值.

justPressed()

判断一个按钮是否被按下

函数原型:

bool justPressed()

justReleased()

判断一个按钮是否被释放.

函数原型:

bool justReleased()

press()

设置按键状态.

函数原型:

void press(bool p)

setLabelDatum()

设置标签基准点.

函数原型:

void setLabelDatum(int16_t x_delta, int16_t y_delta, textdatum_t datum = middle_center)

*1. 关于 TextDatum