QMLのコントロール - Label

提供:MochiuWiki : SUSE, EC, PCB
ナビゲーションに移動 検索に移動

概要

Labelタイプは、Textタイプにスタイルとフォントを継承したものである。
デフォルトの色とフォントはスタイルに依存する。

Labelタイプは、視覚的な背景項目を持つこともできる。

 Label {
    text: "Label"
 }


textプロパティを使用して、テキストの外観を自由に変更することができる。

 Label {
    text: "Hello world"
    font.pixelSize: 22
    font.italic: true
 }


Labelタイプの詳細を知りたい場合は、Qtの公式Webサイトを参照すること。


Labelタイプの独自プロパティ

  • background : Item型
    背景項目を保持する。

    ※注意
    背景アイテムのサイズが明示的に指定されていない場合は、自動的にコントロールのサイズに従う。
    多くの場面では、背景アイテムの幅や高さを指定する必要はない。


  • implicitBackgroundHeight : real型
    暗黙の背景の高さを保持する。
    この値は、background ? background.implicitHeight : 0と等価である。

    このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入された。
    以下に示すimplicitBackgroundWidthプロパティも参照すること。


  • implicitBackgroundWidth : real型
    暗黙の背景幅を保持する。
    この値は、background ? background.implicitWidth : 0と等価である。

    このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入された。
    上記のimplicitBackgroundHeightプロパティも参照すること。


  • topInset : real型
    背景のトップインセットを保持する。

    このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入された。
    QMLのコントロール - Controlレイアウト、および、以下に示すbottomInsetプロパティも参照すること。


  • bottomInset : real型
    背景のボトムインセットを保持する。

    このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入された。
    QMLのコントロール - Controlレイアウト、および、上記のtopInsetプロパティも参照すること。


  • leftInset : real型
    背景の左インセットを保持する。

    このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入された。
    QMLのコントロール - Controlレイアウト、および、以下に示すrightInsetプロパティも参照すること。


  • rightInset : real型
    背景の右インセットを保持する。

    このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入された。
    QMLのコントロール - Controlレイアウト、および、上記のleftInsetプロパティも参照すること。


  • palette : palette型
    ラベルに現在設定されているパレットを保持する。

    このプロパティは、QtQuick.Controls 2.3 (Qt 5.10) で導入された。
    QMLのコントロール - ControlレイアウトにあるControl::paletteプロパティも参照すること。



URLリンクの作成

LabelにURLを貼るには、LabelまたはTextを使用して、MouseAreaを組み合わせる方法がある。
Qt.openUrlExternallyメソッドを使用して、外部ブラウザでURLを開くことができる。

以下の例では、Labelで表示されるテキストをクリックすると、指定したURLがWebブラウザで開かれる。

 import QtQuick 2.15
 import QtQuick.Controls 2.15
 
 ApplicationWindow {
    visible: true
    width: 500
    height: 300
    title: "URL Label Example"
 
    Label {
       text: "Click here to visit a website"
       color: "blue"
       underline: true
 
       MouseArea {
           anchors.fill: parent
           onClicked: {
              Qt.openUrlExternally("http://www.example.com")
           }
       }
    }
 }