たとえばラベルに文字を指定するのに「テキストを設定」を使ってきましたが、このほかにもウィジェットの属性を指定する多くの手段があります。それらすべて「○○を設定」という単語名になっています。

注

フォントの設定はここではなく、フォント をご参照ください。

■属性設定の典型的な手順
　たとえば以下のようなものです。
       プログラム例：
　上記のように、いくつかの属性設定をおこない、最後に「有効化」（または「有効化して配置」）をおこないます。

■後から属性を変更する
　一方、既に描画されているウィジェットの属性を後から変更した場合、既に「有効化」は終っているので別の単語「変更を反映」を使って反映させます。
　後からの属性変更はイベント処理の中でおこなうことが多いでしょう。以下のプログラム例を参考にしてください。

       プログラム例： （後から属性を変更）
       プログラム例： color-change.src のイベント処理部 （実際に実行してみてください）



　すべてのウィジェットは、表示テキスト、文字の色、背景色、フォント、大きさ、位置など、多くの属性を設定できます。

■テキストを設定
　ボタンやラベルなど、文字を表示できるすべてのウィジェットに適用でき、ウィジェットの内部に指定文字列を表示させることができます。
　ボタンやラベルなど、多くのウィジェットでは、複数行に渡る文字列を表示できます。それには文字列の中に改行記号を記入します。
       プログラム例： （文字列定数の継続表記を使う場合）
　上記のように、＆改行＆ の直後でいったん定数を切って「続」を付与し（文字列定数の継続表記）、次の行に２行目を書くと、ソースコードが視覚上も２行になり（しかしコンパイラは最終的に１行扱い）プログラムの意図を把握しやすくなります。
　文字列定数の継続表記を使った実例として、after.src があります。
　　　ラベル１の文言は　文字列定数
　　　　　　　　　　　「・・・・＆改行＆」続
　　　　　　　　　　　「・・・・＆改行＆」続 というソース個所がありますが、表示上５行にわたる文言（コンパイラ扱いとしては１行の文字列定数）を上記のように記述しています。

記：

ウィジェットに設定されたテキストに改行コードを含む場合、GUIエンジンが必要とする改行コードは LF の１文字ですが、本処理単語が介入し、ソースコードの CR,LF の2文字を LF に置換しています。

■テキストを参照
       プログラム例：
       サンプルプログラム：
　既に有効化されているウィジェットに設定されているテキストを参照します。（「テキストを設定」した値を参照することになります）
　参照した文字列はライブラリ内部の文字列実体変数（長さ=8KB）に格納された後、そこを指す文字列情報をスタックに返します。そのため得られた文字列を直ちに消費しないまま再度呼び出すると上書きされてしまうため、ユーザが用意した文字列実体変数に退避するなど工夫してください。

注

ウィジェットに設定されたテキストに改行コードを含む場合、GUIエンジンの改行コードは LF の１文字ですが本処理単語が介入し、Windows標準の CR,LF の連続2文字として返します。

注

本単語とよく似た「指定範囲のテキストを参照」という語もあります。そちらはテキストウィジェット専用です。混同しないよう注意してください。

■テキスト表示の縦横比率
       プログラム例： message.src より抜粋（実際に起動してみてください）


　主にメッセージウィジェットで使う機能です。メッセージウィジェットは（ラベルウィジェットと違い）長いテキストを自動折り畳みして表示できます（意図的に改行することもできます）。折り畳み後にどのような縦横比率になるかの指定がこれになります。
　縦横比率は”縦に対する横の比率”であり、値が大きいほど横長になります。
　デフォルトの比率は１５０(％)ですが、２００〜４００ぐらいを指定すると横長の良い感じになるでしょう。
　ちなみに上のプログラム例にある「％」はMindコンパイラで無視されるのでプログラムとして意味はありません。「３００％」と書いてもコンパイラは「３００」として扱います。人が見て意味が分かりやすいので％を書くことをお勧めします。

■ウィジェット中の文字の揃え方
　次のいずれかでウィジェット内へのテキスト表示が複数行に渡ることがあります。
　　　・ラベルウィジェットへの「テキストを設定」で改行コードを含む文字列を指定
　　　・メッセージウィジェットへの「テキストを設定」で長い文字列を指定
　　　・キャンバス中への「図形としてテキストのＩＤを取得」で長い文字列を指定
　いずれも長い文字列が折り畳まれて表示されますが、そのうち一番長い行よりも短い行を左右どちらに寄せるかを指定できます。デフォルトは「中央揃え」です。
       サンプルプログラム： label-justify

■ウィジェットに立体感を持たせる（立体感と縁（ふち）の幅の設定）
　ウィジェットに立体感を付けます。デフォルトは「平坦」（立体感無し）ですが、ボタンに限りデフォルトが「出っ張り」です。
　「立体感を設定」だけでは立体感が弱い場合は「縁の幅を設定」も併用して縁を太くすると強調されます。
       サンプルプログラム： "button-relief" および "label-relief"

■ウィジェットのサイズの指定

       サンプルプログラム：
　ウィジェットの大きさは、そこに含む文字、イメージ、パディングなどを考慮してGUIライブラリが自動的に決定しますが、これらを使うと大きさを明示できます。
　ウィジェット内に表示する文字列が長い場合（特にラベルウィジェットで）指定したウィジェットサイズを超えた文字列が切れてしまうことに注意が必要です。

■ウィジェットの文字色と背景色
　ウィジェット内に書かれる文字の色および背景色を指定します。
　＜色指定＞は文字列で、以下のいずれかの表記によります。
　　色見本(色の見え方)として他社様のサイトではありますが、以下のWebページが参考になります。
　　　　　WEB色見本 原色大辞典 - HTMLカラーコード
　　　　　→ https://www.colordic.org/　（別タブで開きます）

■イメージの埋め込み

注

下記で「イメージＩＤ」を扱っていますが、詳細は 「イメージ」−「イメージデータの生成」 にて改めて解説しますのでそちらを参照してください。

       サンプルプログラム： image-photo.src
　ウィジェットにイメージを入れるには上記のように二段階の処理となります。
　最初に「イメージをロード」を実行するとイメージファイル内容がデコードされてメモリ内に格納され、ＩＤが返されます。
　次に、そのイメージＩＤを使って「イメージを設定」とすることで、ウィジェットに対してイメージが埋め込まれます。


　イメージはラベルやボタンのほか、テキストウィジェットやキャンバスにも入れることができます。
　たとえばラベルに対して、イメージとテキストを合わせて入れることもできますが、イメージ単独であっても構いません。ボタンについても同様です。

       サンプルプログラム：

■イメージ埋め込みの位置揃え
　たとえばラベルに文字とイメージ(またはビットマップ)を混ぜることができますがその際のイメージ配置を指定できます。デフォルトは左揃えなので、左側にイメージ、その右にテキストが入ります。

■ビットマップの埋め込み

ビットマップ名は以下の文字列定数をお使いください。

　　　　　　ビットマップ・errorは 　　　文字列定数　「error」。
　　　　　　ビットマップ・gray12は　　　文字列定数　「gray12」。　網掛け用
　　　　　　ビットマップ・gray25は　　　文字列定数　「gray25」。　網掛け用
　　　　　　ビットマップ・gray50は　　　文字列定数　「gray50」。　網掛け用
　　　　　　ビットマップ・gray75は　　　文字列定数　「gray75」。　網掛け用
　　　　　　ビットマップ・hourglassは 　文字列定数　「hourglass」。
　　　　　　ビットマップ・infoは　　　　文字列定数　「info」。
　　　　　　ビットマップ・questheadは 　文字列定数　「questhead」。
　　　　　　ビットマップ・questionは　　文字列定数　「question」。
　　　　　　ビットマップ・warningは 　　文字列定数　「warning」。

注：各ビットマップがどのような見え方になるかは、
　　"image-bitmap-all.exe" を起動してご覧ください。

注：grayXX というビットマップは単独で使うのでなく
　　テキストウィジェットなどで文字を網掛けにする目的で使われます。

　全てのビットマップ名をプログラムとして網羅したい場合は以下の配列をお使いください。

　　　　　　ビットマップのシンボル配列は　文字列定数配列
　　　　　　　　「error」
　　　　　　　　「gray12」
　　　　　　　　「gray25」
　　　　　　　　「gray50」
　　　　　　　　「gray75」
　　　　　　　　「hourglass」
　　　　　　　　「info」
　　　　　　　　「questhead」
　　　　　　　　「question」
　　　　　　　　「warning」。

       プログラム例： image-bitmap.src
　「ビットマップ」と呼ばれるイメージ形式をイメージ埋め込みする場合は上記のようになります（注：通常のイメージとは扱いが異なります）。
　ビットマップは、小さなイメージを高速に扱うデータ形式です。小さいという意味ではWindowsでのアイコン形式と似ていますが、こちらはカラーは扱えずモノクロです。その代わり、ビットマップは背景が透明であるためビットマップを含むウィジェットに背景色を与えることでウィジェットになじみやすくなすます。
　ビットマップはラベルやボタンのほか、テキストウィジェットやキャンバスにも入れることができます。
　たとえばラベルに対して、ビットマップとテキストを合わせて入れることもできますが、ビットマップ単独であっても構いません。ボタンについても同様です。
　ビットマップ単独　（ダイアログでの利用例）
　（ビットマップとテキストは別のラベルを使っています）

　ビットマップ＋テキスト
　（ビットマップとテキストは同じラベル内です）
　（両者に背景が入り込むので一体になって見えます）

　ビットマップをウィジェットに埋め込むサンプルとして "image-bitmap" を参考にしてください。実行すると分かりますが、ラベルの背景色がビットマップの背景に入り込むのでなじんでいます。（すべてのビットマップを一気に表示するサンプルは "image-bitmap-all.exe" です）
　ビットマップはモノクロ（背景色は可）で小さいという欠点はあるものの、標準ビットマップはライブラリ内蔵のデータなので別にファイルを用意しなくて良いほか、描画も速いという利点があります。本GUIライブラリのダイアログにおいてアンコン表示にビットマップを使っています。

■寄せを設定（文字の位置揃え）
　ウィジェットの中に描画する文字の位置を指定するものです。デフォルトでは上下左右の中央になっています。

注

配置でもこの処理単語が使えます。
→ 配置の詳しい解説 参照

       プログラム例：
       サンプルプログラム：



■ウィジェットの有効/無効
       プログラム例： disable-button.src より抜粋


　たとえばボタンやメニューボタンなど操作すると何か動作が発生するものは、一時的に無効にできます。Mindの文字列定数のシンボル「無効状態」を指定すると無効となり、「通常状態」で元に戻ります。ウィジェットへの属性変更であるため引き続いて「変更を反映」を実行してください。

■ウィジェットの状態を参照
       サンプルプログラム：
　前記「状態を設定」の関連語です。現在の状態を知ることができます。文字列が返されます。
　参照した文字列はライブラリ内部の文字列実体変数（長さ=20桁）に格納された後、そこを指す文字列情報をスタックに返します。もし得られた文字列をただちに消費しないまま再度呼び出すると上書きされてしまうため、ユーザが用意した文字列実体変数に退避するなど工夫してください。

---

注

以下の属性設定は 配置の詳しい解説 で解説します。
　　　パディング
　　　並べ方向を設定
　　　横に伸ばす
　　　縦に伸ばす
　　　縦横に伸ばす
　　　占有領域を拡張
　　　フレーム

注

フォント関連の属性設定は フォント で解説します。

注

ウィンドウ関連の属性設定は ウィンドウ操作 で解説します

• 
• 　　　　　　　　　　　　　　　　
• 　　

---