最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

matlab.settings.FactoryGroup.createToolboxGroup

ツールボックスの FactoryGroup ルート オブジェクトを作成

説明

s = matlab.settings.FactoryGroup.createToolboxGroup(name) は、ツールボックスのルート出荷時グループを作成し、新しいグループを FactoryGroup オブジェクトとして返します。既定では、ルート出荷時グループは非表示です。つまり、親設定グループ内に表示されません。

s = matlab.settings.FactoryGroup.createToolboxGroup(___,Name,Value) は、1 つ以上の名前と値のペアの引数を使用して、ルート出荷時グループのプロパティを指定します。たとえば、'Hidden',false は、表示される FactoryGroup ルート オブジェクトを作成します。名前と値のペアは他のすべての入力引数の後で指定します。

すべて折りたたむ

ツールボックス mytoolbox のルート出荷時グループを作成して表示します。

s = matlab.settings.FactoryGroup.createToolboxGroup('mytoolbox', ...
    'Hidden',false);

ルート出荷時グループを作成して既定の検証関数を指定します。この関数は、独自の検証関数を指定していないグループ内のすべての出荷時設定の値を検証します。サブグループまたは設定で独自の検証関数を指定しない限り、これにはサブグループ内の設定も含まれます。

まず、入力が数値でない場合にエラーをスローする検証関数 numericValidationFcn を作成します。

function numericValidationFcn(x)
    errorMsg = 'Value must be numeric.'; 
    assert(isnumeric(x),errorMsg);
end

ルート出荷時グループ mytoolbox を作成します。検証関数 numericValidationFcn を指定します。

s = matlab.settings.FactoryGroup.createToolboxGroup('mytoolbox', ...
    'Hidden',false,'ValidationFcn',@numericValidationFcn);

ルート出荷時設定グループ内の設定が数値以外の値に設定されている場合、MATLAB® はエラーをスローします。

入力引数

すべて折りたたむ

ツールボックスのルート出荷時グループの名前。文字ベクトルまたは string として指定します。ルート出荷時グループ name が存在する場合、MATLAB はエラーを表示します。

名前と値のペアの引数

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

例: matlab.settings.FactoryGroup.createToolboxGroup('myToolbox','Hidden',false) は、表示されるルート出荷時グループを作成します。

非表示の状態。true または false として指定します。

true に設定した場合、出荷時グループ (すべての出荷時グループとそのグループ内の出荷時設定を含む) は表示されませんが、アクセスは可能なままです。

グループ内の出荷時設定を検証する関数。関数ハンドルとして指定します。指定した関数は、グループ内で独自の検証関数が指定されていないすべての出荷時設定の値を検証するために使用されます。サブグループまたは設定で独自の検証関数を指定しない限り、これにはサブグループ内の設定も含まれます。

関数ハンドルを関連付ける関数は、設定可能な値を入力引数として受け入れ、出力引数をもたず、検証が失敗した場合にエラーをスローするものでなければなりません。

関数ハンドルは、MATLAB パス上の関数をポイントしなければなりません。無名または入れ子の関数ハンドルはサポートされません。

R2019b で導入