MESCIUS SPREAD for Windows Forms 17.0J > 開発者ガイド > ファイル入出力 > 保存 > ユーザー設定プロパティの設定 |
「ユーザー設定」プロパティは、ワークブックに追加して、その内容、目的、またはその他の関連情報を説明を追加できるメタデータフィールドです。ユーザー設定プロパティには、テキスト、日付、または数値を指定して、提案された名前のリストからカスタム名を選択できます。また、種類を「はい/いいえ」として選択することで、値を「はい」または「いいえ」に設定することもできます。
追加のユーザー設定プロパティを追加するには、IDocumentProperties インターフェースの CustomDocumentProperties オブジェクトを使用します。このオブジェクトは、ワークブックのユーザー設定プロパティのコレクションを表します。
SPREAD デザイナでは、「ファイル」メニューの「プロパティ」ダイアログのにある「ユーザー設定」タブで、ワークブックのユーザー設定 プロパティにアクセスできます。
コードまたは実行時にリボンコントロール使用してユーザー設定プロパティを追加するには、次の手順に従います。
コードの使用
C# コードのコピー// コードからプロパティダイアログを開きます FarPoint.Win.Spread.Dialogs.BuiltInDialogs.DocumentProperties(fpSpread1.AsWorkbook());
Visual Basic コードのコピー'コードからプロパティダイアログを開きます FarPoint.Win.Spread.Dialogs.BuiltInDialogs.DocumentProperties(fpSpread1.AsWorkbook())
リボンコントロールの使用
次のサンプルコードを実行して、fpSpread でリボンコントロールをアタッチします。
C# コードのコピー ribbonBar1.Attach(fpSpread1);
Visual Basic コードのコピー ribbonBar1.Attach(fpSpread1)
「ファイル」メニューを開きます。
「プロパティ」を選択して、「プロパティ」ダイアログを開きます。
コードの使用
次のサンプルコードは、「プロパティ」 ダイアログに「ユーザー設定」プロパティを追加する方法を示しています。
C# コードのコピー // コードを使用して、プロパティを追加します fpSpread1.AsWorkbook().CustomDocumentProperties.Add("Client", GrapeCity.Core.DocumentPropertyType.Boolean, true); fpSpread1.AsWorkbook().CustomDocumentProperties.Add("Date completed", GrapeCity.Core.DocumentPropertyType.Date, new System.DateTime(2023, 3, 12)); fpSpread1.AsWorkbook().CustomDocumentProperties.Add("Document number", GrapeCity.Core.DocumentPropertyType.Number, 123); fpSpread1.AsWorkbook().CustomDocumentProperties.Add("Language", GrapeCity.Core.DocumentPropertyType.String, "English"); FarPoint.Win.Spread.Dialogs.BuiltInDialogs.DocumentProperties(fpSpread1.AsWorkbook());
VB コードのコピー ' コードを使用して、プロパティを追加します fpSpread1.AsWorkbook().CustomDocumentProperties.Add("Client", GrapeCity.Core.DocumentPropertyType.[Boolean], True) fpSpread1.AsWorkbook().CustomDocumentProperties.Add("Date completed", GrapeCity.Core.DocumentPropertyType.[Date], New DateTime(2023, 3, 12)) fpSpread1.AsWorkbook().CustomDocumentProperties.Add("Document number", GrapeCity.Core.DocumentPropertyType.Number, 123) fpSpread1.AsWorkbook().CustomDocumentProperties.Add("Language", GrapeCity.Core.DocumentPropertyType.[String], "English") FarPoint.Win.Spread.Dialogs.BuiltInDialogs.DocumentProperties(fpSpread1.AsWorkbook())
リボンコントロールの使用
i. 「ユーザー設定」タブをクリックして、次の詳細を入力します。
ii. 「追加」 をクリックした後、「OK」 をクリックして、ユーザー設定 プロパティを追加します。
Spread では、要件に応じて既存のユーザー設定プロパティを変更または削除することができます。プロパティを変更するには、「プロパティ」テーブルからプロパティ名を選択し、必要な変更を行って、「変更」ボタンをクリックして保存します。同様に、プロパティ名を選択して「削除」ボタンをクリックと、不要なユーザー設定プロパティを削除できます。
SPREAD では、カスタムプロパティシートに識別子情報を追加することができます。 CustomProperties は、ワークシートに関連する追加のメタデータや情報を保存するために使用されます。 ワークシートにカスタムプロパティを追加するには、IWorksheet インターフェイスの CustomProperties プロパティを使用します。
ワークシートにメタデータを追加/削除するには、CustomPropertiesの追加/削除メソッドを使用することもできます。
以下のコードを使用して、ワークシートレベルで識別情報の追加と削除をします。
C# |
コードのコピー
|
---|---|
IWorksheet sheet = fpSpread1.AsWorkbook().ActiveSheet; object[,] properties = new object[,] { { "Department", 3 }, { "Editor", "Serena"}, { "Project", "Spread"}, { "Status", true} }; for (int i = 0; i < 4; i++) { sheet.CustomProperties.Add(properties[i, 0].ToString(), properties[i, 1]); } sheet.CustomProperties[0].Delete(); sheet.CustomProperties[0].Delete(); Console.WriteLine(sheet.CustomProperties[0].Name); Console.WriteLine(sheet.CustomProperties[1].Name); |
VB |
コードのコピー
|
---|---|
Dim sheet As IWorksheet = FpSpread1.AsWorkbook().ActiveSheet Dim properties As Object(,) = New Object(,) { {"Department", 3}, {"Editor", "Serena"}, {"Project", "Spread"}, {"Status", True}} For i As Integer = 0 To 4 - 1 sheet.CustomProperties.Add(properties(i, 0).ToString(), properties(i, 1)) Next sheet.CustomProperties(0).Delete() sheet.CustomProperties(0).Delete() Console.WriteLine(sheet.CustomProperties(0).Name) Console.WriteLine(sheet.CustomProperties(1).Name) |