MESCIUS SPREAD for Windows Forms 17.0J
ユーザー設定プロパティの設定

「ユーザー設定」プロパティは、ワークブックに追加して、その内容、目的、またはその他の関連情報を説明を追加できるメタデータフィールドです。ユーザー設定プロパティには、テキスト、日付、または数値を指定して、提案された名前のリストからカスタム名を選択できます。また、種類を「はい/いいえ」として選択することで、値を「はい」または「いいえ」に設定することもできます。

追加のユーザー設定プロパティを追加するには、IDocumentProperties インターフェースの CustomDocumentProperties オブジェクトを使用します。このオブジェクトは、ワークブックのユーザー設定プロパティのコレクションを表します。

SPREAD デザイナでは、「ファイル」メニューの「プロパティ」ダイアログのにある「ユーザー設定」タブで、ワークブックのユーザー設定 プロパティにアクセスできます。

 

コードまたは実行時にリボンコントロール使用してユーザー設定プロパティを追加するには、次の手順に従います。

  1. 「プロパティ」ダイアログを開きます。 

    コードの使用 

    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)
    

    ファイル」メニューを開きます。

    「プロパティ」を選択して、「プロパティ」ダイアログを開きます。

  2. [プロパティ] ダイアログにユーザー設定のプロパティを 追加します。

コードの使用

次のサンプルコードは、「プロパティ」 ダイアログに「ユーザー設定」プロパティを追加する方法を示しています。

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)

 

 


© MESCIUS inc. All rights reserved.