Main Content

このページは前リリースの情報です。該当の英語のページはこのリリースで削除されています。

addLabel

(非推奨) プロジェクト ファイルにラベルを追加

simulinkproject は推奨されません。代わりに currentProject または openProject を使用してください。詳細については、互換性についての考慮事項を参照してください。

説明

addLabel(file,categoryName,labelName) は、カテゴリ categoryName の指定されたラベル labelName をファイルに追加します。

addLabel(file,categoryName,labelName,labelData) は、labelData で指定したデータをもつラベルを追加します。

すべて折りたたむ

機体のプロジェクトを開き、プロジェクト オブジェクトを作成します。

sldemo_slproject_airframe;
proj = simulinkproject;

名前を指定して、特定のファイルを取得します。

myfile = findFile(proj,'models/AnalogControl.slx')
myfile = 

  ProjectFile with properties:

      Path: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
    Labels: [1x1 slproject.Label]
  Revision: '2'
SourceControlStatus: Unmodified

ファイルの Labels プロパティを取得します。

myfile.Labels
ans = 

  Label with properties:

            File: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
            Data: []
        DataType: 'none'
            Name: 'Design'
    CategoryName: 'Classification'

ファイルに 'Artifact' ラベルを追加します。

addLabel(myfile,'Classification','Artifact')
ans = 

  Label with properties:

            File: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
            Data: []
        DataType: 'none'
            Name: 'Artifact'
    CategoryName: 'Classification'

Labels プロパティにインデックスを作成し、このファイルに付けられたラベルを取得します。

reviewlabel = myfile.Labels(1)
reviewlabel = 

  Label with properties:

            File: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
            Data: []
        DataType: 'none'
            Name: 'Artifact'
    CategoryName: 'Classification'

ファイルから新規ラベルを削除します。

removeLabel(myfile,reviewlabel)

'Classification' カテゴリ ラベル 'Utility' をプロジェクト内で .m ファイル拡張子をもつすべてのファイルに追加します。

機体のプロジェクトを開き、プロジェクト オブジェクトを作成します。

sldemo_slproject_airframe;
proj = simulinkproject;

ファイル一覧を取得します。

files = proj.Files;

各ファイルに対して作業を繰り返します。ファイルに .m という拡張子が含まれる場合、'Utility' ラベルを追加します。

for fileIndex = 1:numel(files)
   file = files(fileIndex);
   [~, ~, fileExtension] = fileparts(file.Path);
   if strcmp(fileExtension,'.m')
       addLabel(file,'Classification','Utility');
   end
end

プロジェクトの [ファイル] ビューで、[分類] 列に [ユーティリティ] フォルダーの各 .m ファイルに対してラベル [ユーティリティ] が表示されます。

機体のプロジェクトを開き、プロジェクト オブジェクトを作成します。

sldemo_slproject_airframe;
proj = simulinkproject;

新規カテゴリ 'Review' を作成します。

createCategory(proj,'Review','char');

新しいカテゴリに対して、ラベル 'To Review' を作成します。

reviewCategory = findCategory(proj,'Review');
createLabel(reviewCategory,'To Review');

名前を指定して、特定のファイルを取得します。

myfile = findFile(proj,'models/AnalogControl.slx')
myfile = 

  ProjectFile with properties:

      Path: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
    Labels: [1x1 slproject.Label]
 Revision: '2'
SourceControlStatus: Unmodified

ファイルに 'To Review' ラベル、およびラベル データの文字ベクトルを追加します。

addLabel(myfile,'Review','To Review','Whole team design review')

Labels プロパティにインデックスを作成し、このファイルに付けられた 2 番目のラベルを取得します。また、ラベル データを確認します。

myfile.Labels(2)
ans = 

  Label with properties:

            File: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
            Data: 'Whole team design review'
        DataType: 'char'
            Name: 'To Review'
    CategoryName: 'Review'

プロジェクトの [ファイル] ビューで、AnalogControl.slx ファイルに対して、ラベル [レビュー対象] がラベル データとともに [確認] 列に表示されます。

または、データ プロパティを使用してラベル データを設定または変更することができます。

mylabel = myfile.Labels(2);
mylabel.Data = 'Final review';

入力引数

すべて折りたたむ

ラベルを追加するファイル。ファイル オブジェクトとして指定されます。ファイル オブジェクトを取得するには、プロジェクトの Files プロパティ (proj.Files) を調べるか、関数 findFile を使用して名前でファイルを検索します。ファイルはプロジェクト内になければなりません。

ラベルのカテゴリ名。文字ベクトルとして指定されます。

追加するラベルの名前。文字ベクトルとして指定されます。または、file.Label プロパティや関数 findLabel によって返されるラベル定義オブジェクトとして指定されます。プロジェクトに存在しないラベル名を新規に指定することができます。

ラベルに追加するデータ。文字ベクトルまたは数値として指定されます。データ型は、ラベルの定義によって異なります。その DataType プロパティを調べるには、file.Label または関数 findLabel を使用してラベルを取得します。

互換性についての考慮事項

すべて展開する

R2019a 以降は非推奨

R2013a で導入