uiswitch

スライダー スイッチ、ロッカー スイッチまたはトグル スイッチの各コンポーネントを作成

構文

sw = uiswitch

sw = uiswitch(style)

sw = uiswitch(parent)

sw = uiswitch(parent,style)

sw = uiswitch(___,Name,Value)

説明

sw = uiswitch は、スライダー スイッチを新しい Figure ウィンドウ内に作成し、Switch オブジェクトを返します。MATLAB^® は関数 uifigure を呼び出してこの Figure を作成します。

sw = uiswitch(style) は指定されたスタイルのスイッチを作成します。

sw = uiswitch(parent) は、指定された親コンテナー内にスイッチを作成します。親には、関数 uifigure を使用して作成された Figure か、またはその子コンテナーのいずれかを指定できます。

sw = uiswitch(parent,style) は、指定された親コンテナー内に指定されたスタイルのスイッチを作成します。

sw = uiswitch(___,Name,Value) は、1 つ以上の Name,Value のペアの引数を使用して、オブジェクトのプロパティを指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。

例

Figure ウィンドウにスライダー スイッチを作成

fig = uifigure;
sliderswitch = uiswitch(fig);

Figure ウィンドウにトグル スイッチを作成

fig = uifigure;
toggleswitch = uiswitch(fig,'toggle');

パネル内にロッカー スイッチを作成

パネル内にロッカー スイッチを作成します。

fig = uifigure;
pnl = uipanel(fig);
rockerswitch = uiswitch(pnl,'rocker');

スイッチのプロパティ値の設定とアクセス

ロッカー スイッチを作成します。

fig = uifigure;
rockerswitch = uiswitch(fig,'rocker');

スイッチのテキストを変更します。

rockerswitch.Items = {'Stop','Start'};

現在のスイッチの値を調べます。

val = rockerswitch.Value

val =

    'Stop'

ランプの色を変更するスイッチ

次のコードを MATLAB パス上に lampswitch.m として保存します。次のコードはランプとロッカー スイッチを含むアプリを作成します。ユーザーがスイッチを切り替えると、ValueChangedFcn コールバックがランプの色を変更します。

function lampswitch
fig = uifigure('Position',[100 100 370 280]);


lmp = uilamp(fig,...
    'Position',[165 75 20 20],...
    'Color','green');


sw = uiswitch(fig,'toggle',...
    'Items',{'Go','Stop'},...    
    'Position',[165 160 20 45],...
    'ValueChangedFcn',@switchMoved); 

% ValueChangedFcn callback
function switchMoved(src,event)  
    switch src.Value
        case 'Go'
            lmp.Color = 'green';
        case 'Stop'
            lmp.Color = 'red';
        end
    end
end

lampswitch を実行し、スイッチをクリックして色が変更されることを確認します。

入力引数

style — スイッチのスタイル

'slider' (既定値) | 'rocker' | 'toggle'

スイッチのスタイル。次の表の値として指定します。

スタイル	外観
'slider'
'rocker'
'toggle'

parent — 親コンテナー

Figure オブジェクト (既定値) | Tab オブジェクト | Panel オブジェクト | ButtonGroup オブジェクト | GridLayout オブジェクト

親コンテナー。関数 uifigure を使用して作成された Figure オブジェクト、またはその子コンテナー (Tab、Panel、ButtonGroup または GridLayout) のいずれかとして指定します。親コンテナーを指定しない場合、MATLAB は関数 uifigure を呼び出し、親コンテナーとして機能する新しい Figure オブジェクトを作成します。

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。ここで Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name を引用符で囲みます。

例: 'Text',{'0','1'} は、スイッチの 2 つの状態として “0" および “1" を指定します。

各タイプのスイッチは、異なるプロパティのセットをサポートします。プロパティの完全なリストと各タイプについての説明は、対応するプロパティのページを参照してください。

• Switch のプロパティ

• RockerSwitch のプロパティ

• ToggleSwitch のプロパティ

バージョン履歴

R2016a で導入

R2023b: 項目リスト内のコンポーネント値のインデックスへのアクセス

ValueIndex プロパティを使用して、項目リスト内のコンポーネント値のインデックスにアクセスします。

参考

関数

• uifigure

プロパティ

• Switch のプロパティ | RockerSwitch のプロパティ | ToggleSwitch のプロパティ

ツール

• App Designer