addGroup
説明
s = addGroup(
は、指定した親出荷時設定グループに出荷時設定グループ parentgroup
,name
)name
を追加し、新しいグループを FactoryGroup
オブジェクトとして返します。既定では、出荷時設定グループは非表示です。つまり、親設定グループ内に表示されません。
s = addGroup(___,
は、1 つ以上の名前と値のペアの引数を使用して、出荷時グループのプロパティを指定します。たとえば、Name,Value
)'Hidden',false
は、出荷時設定ツリーに表示されるグループを追加します。名前と値のペアは他のすべての入力引数の後で指定します。
例
出荷時設定グループの追加
ツールボックス mytoolbox
のルート出荷時グループを作成し、ツリーにグループを追加します。
ルート出荷時グループ mytoolbox
を作成します。
myToolboxFactoryTree = matlab.settings.FactoryGroup.createToolboxGroup('mytoolbox', ... 'Hidden',false);
font
グループをツリーに追加します。
toolboxFontGroup = addGroup(myToolboxFactoryTree,'font','Hidden',false);
グループ内の設定を検証
設定グループを追加し、既定の検証関数を指定します。この関数は、独自の検証関数を指定する設定を除いて、グループ内のすべての設定の値を検証します。サブグループまたは設定で独自の検証関数を指定しない限り、これにはサブグループ内の設定も含まれます。
まず、入力が数値でない場合にエラーをスローする検証関数 numericValidationFcn
を作成します。
function numericValidationFcn(x) errorMsg = 'Value must be numeric.'; assert(isnumeric(x),errorMsg); end
ルート出荷時グループ mytoolbox
を作成し、グループ mynumericsettings
をツリーに追加します。検証関数 numericValidationFcn
を指定します。グループ内の設定が数値以外の値に設定されていると、MATLAB® はエラーをスローします。
myToolboxFactoryTree = matlab.settings.FactoryGroup.createToolboxGroup('mytoolbox', ... 'Hidden',false); toolboxFontGroup = addGroup(myToolboxFactoryTree,'mynumericsettings','Hidden',false, ... 'ValidationFcn',@numericValidationFcn);
入力引数
parentgroup
— 親出荷時グループ
FactoryGroup
オブジェクト
グループの追加先の親出荷時グループ。FactoryGroup
オブジェクトとして指定します。関数 matlab.settings.FactoryGroup.createToolboxGroup
を使用してルート出荷時グループ オブジェクトを作成します。
例: addGroup(s.mytoolbox,'newGroup')
name
— 追加する出荷時グループの名前
文字ベクトル | string
追加する出荷時グループの名前。文字ベクトルまたは string として指定します。指定した親出荷時グループ内に出荷時グループ name
が既に存在する場合、MATLAB はエラーを表示します。
例: addGroup(s.mytoolbox,'newGroup')
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: addGroup(parentGroup,'newGroup','Hidden',false)
は表示される出荷時グループを作成します。
Hidden
— 非表示の状態
true
(既定値) | false
非表示の状態。true
または false
として指定します。
true
に設定した場合、出荷時グループ (すべての出荷時グループとそのグループ内の出荷時設定を含む) はコマンド ウィンドウやタブ補完の一部としては表示されませんが、アクセスは可能なままです。
ValidationFcn
— グループ内の設定を検証する関数
関数ハンドル
グループ内の出荷時設定を検証する関数。関数ハンドルとして指定します。指定した関数は、独自の検証関数を指定する設定を除いて、グループ内のすべての出荷時設定の値を検証します。サブグループまたは設定で独自の検証関数を指定しない限り、これにはサブグループ内の設定も含まれます。
関数ハンドルを関連付ける関数は、設定可能な値を入力引数として受け入れ、出力引数をもたず、検証が失敗した場合にエラーをスローするものでなければなりません。
関数ハンドルは、MATLAB パス上の関数をポイントしなければなりません。無名または入れ子の関数ハンドルはサポートされません。
バージョン履歴
R2019b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)