主要内容

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

uitogglebutton

トグル ボタン コンポーネントの作成

説明

结核病= uitogglebuttonは、ボタン グループ内にトグル ボタンを作成し、切换按钮オブジェクトを返します。MATLAB®は関数uifigureを呼び出してこのボタン グループの親 图形を作成します。

结核病=uitogglebutton(父母亲)は、指定されたボタン グループ内にトグル ボタンを作成します。ボタン グループは関数uifigureで作成された图形の子であるか、または 图形の子コンテナー (标签面板按钮组または网格布局)を親としなければなりません。

结核病=uitogglebutton(___,名称、值)は、1.つ以上の名称、值のペアの引数を使用して,切换按钮のプロパティを指定します。このオプションは,前述の構文のすべての入力引数の組み合わせで使用できます。

すべて折りたたむ

トグル ボタンを作成するために、まず、トグル ボタンを含める 图形ウィンドウとボタン グループを作成します。

图=uifigure(“位置”,[680 678 398 271]);bg=ui按钮组(图,“位置”,[137 113 123 85]);

トグル ボタンを 3.個作成し、それぞれの位置を指定します。

tb1=uitogglebutton(背景、,“位置”,[10 50 100 22]);tb2=uitogglebutton(背景,“位置”,[10 28 100 22]);tb3=uitogglebutton(背景,“位置”,[10 6 100 22]);

各トグル ボタンに関連付けられているテキストを変更します。

tb1.文本=“英语”;待定2.文本=“法语”;tb3。文本=“德语”

プログラムにより、トグル ボタンの選択を [德语]に変更します。

tb3.值=真;

[德语]トグル ボタンのテキストのフォント名を調べます。

font=tb3.FontName
= Helvetica字体

入力引数

すべて折りたたむ

親コンテナー。按钮组オブジェクトとして指定します。按钮组は,関数uifigureを使用して作成された图形,またはuifigureの子コンテナー (标签面板按钮组または网格布局)を親としなければなりません。

名前と値のペアの引数

オプションの名称、值の引数ペアをコンマ区切りで指定します。名称は引数名で、价值は対応する値です。名称は引用符で囲まなければなりません。Name1, Value1,…,的家のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例:“文本”、“法语”は、トグル ボタンに表示するテキストを “法语”に指定します。

以下にリストするプロパティは、利用できるプロパティの一部です。完全なリストについては、切换按钮のプロパティを参照してください。

トグル ボタンの状態。0(押されていない) または1.(押されている) として指定します。ボタン グループ内で一度に選択できる (押すことができる) トグル ボタンは 1.つのみです。价值プロパティが1.に設定されている場合,トグルボタンは押されている状態で表示されます。既定では,ボタングループに最初に追加されたボタンの状態が1.です。同じボタン グループに追加された後続ボタンの既定の状態は0です。

切换按钮价值プロパティが1.に変更されるときに、直前に選択されていた切换按钮价值プロパティは0に変更されます。さらに、按钮组选定对象プロパティ値が更新されます。

プログラムにより切换按钮价值プロパティを0に変更した場合、MATLABは按钮组に "追加された"最初の切换按钮价值プロパティを1.に設定します。追加した最初の切换按钮价值プロパティがプログラムにより0に設定されている場合、MATLABは、按钮组に追加された切换按钮价值プロパティを1.に設定します。

メモ

按钮组に最初に "追加"された切换按钮が、按钮组儿童プロパティの最初に "リスト"される切换按钮とは限りません。

ボタン ラベル。文字ベクトル、文字ベクトルの 单间牢房配列、一串スカラー、一串配列、または 1.次元の 明确的配列として指定します。ボタンに 1.行のテキストのラベルを付ける場合は文字ベクトルまたは 一串スカラーを指定します。ボタンに複数行のテキストのラベルを付ける場合は 单间牢房配列または 一串配列を使用します。配列の各要素は、テキストの各行を表します。このプロパティを 明确的配列として指定した場合、MATLABはカテゴリの完全なセットではなく、配列内の値を使用します。

アイコンのソースまたはファイル。文字ベクトル、一串スカラー、またはMxNx3のトゥルーカラー イメージ配列として指定します。ファイル名には、MATLABパス上のイメージ ファイル名、あるいはイメージ ファイルへの絶対パスを指定できます。他のユーザーとアプリを共有する予定の場合は、アプリのパッケージ化を容易にするためにイメージ ファイルを MATLABパス上に配置します。

サポートされているイメージ形式には、JPEG、PNG、GIF、SVGまたはMxNx3のトゥルーカラー イメージ配列が含まれます。トゥルーカラー イメージ配列の詳細については、イメージの種類を参照してください。

  • 位置プロパティ値で指定されたすべての領域をボタンのテキストが占有する場合,MATLABはアイコンを表示しません。

  • アイコンに利用可能な領域がいくらかある場合、MATLABは必要に応じて、その領域に収まるようにイメージを縮小します。

例:“icon.png”は、MATLABパス上のアイコン ファイルを指定します。

例:'C:\Documents\icon.png'は、イメージ ファイルへの絶対パスを指定します。

ボタンの位置とサイズ。[左下宽高]の形式のベクトルとして指定します。次の表で,ベクトルの各要素について説明します。

要素 説明
左边 ボタン グループの内側左端からボタンの外側左端までの距離
底部 ボタン グループの内側下端からボタンの外側下端までの距離
宽度 ボタンの外側の右端と左端の間の距離
身高 ボタンの外側の上端と下端の間の距離

位置の値は、ボタン グループの"描画可能領域"を基準とした相対値です。描画可能領域は,ボタングループの境界線の内側にある領域で,タイトルが占める領域は含まれません。

すべての測定単位はピクセルです。

ヒント

  • ボタン グループには任意の 用户界面コンポーネントのタイプを含めることができますが、管理できるのはラジオ ボタンとトグル ボタンの選択だけです。

  • ボタン グループ内のラジオ ボタンまたはトグル ボタンをアプリ ユーザーが選択したときにプログラムを応答させるには、按钮组オブジェクトのコールバック関数SelectionChangedFcnを定義します。個々のボタンのコールバックを定義することはできません。

  • 選択されているラジオ ボタンまたはトグル ボタンを判定するには、按钮组オブジェクトの选定对象プロパティをクエリします。このクエリは、コード内の任意の場所で実行できます。

  • 按钮组オブジェクトの看得见的プロパティが“关”に設定されている場合、それに含まれる子オブジェクトは、親按钮组と共に非表示になります。ただし、個々の子オブジェクトの看得见的"プロパティ値" は影響を受けません。

R2016aで導入