5.1. SMCloudServices

SMCSサービスの機能を提供します。

  • メソッド

    名称

    説明

    ShowRegistrationView

    スター精密クラウドサービス登録のビューを表示します。

    IsRegistered

    アプリケーションがスター精密クラウドサービスに登録されているか確認します。

    SetRegistrationConfigFilePath

    スター精密クラウドサービス登録情報を保存する場所を設定します。

    GetRegistrationConfigFilePath

    スター精密クラウドサービス登録情報の保存する場所を取得します。

    GetSMCloudServicesVersion

    SMCloudServicesSolutionライブラリのバージョンを取得します。

  • イベント

    名称

    説明

    RegisteredEvent

    スター精密クラウドサービス登録ビューを閉じたときに発生します。

重要

本クラスの各メソッドは、必ず SetRegistrationConfigFilePath メソッドを実行し、 スター精密クラウドサービス登録情報を保存する場所を正しく設定できたことを確認してから、ご使用ください。

重要

スター精密クラウドサービス登録情報は、アプリケーションのアンインストール時に削除してください。 削除後に再度スター精密クラウドサービスを利用する場合、 SetRegistrationConfigFilePath メソッドを実行してファイルの保存場所を作成してください。

5.1.1. ShowRegistrationView

スター精密クラウドサービス登録のビューを表示します。

  • 宣言

    public void ShowRegistrationView()
    public void ShowRegistrationView(Window ownerWindow)
    
  • 引数

    名称 説明
    ownerWindow スター精密クラウドサービス登録ビューを表示する親Windowクラス System.Windows.Window
  • 戻り値

    なし

クラス 説明
InvalidOperationException SetRegistrationConfigFilePath メソッドでスター精密クラウドサービス登録情報を保存する場所を正しく設定する前に本メソッドを実行した場合に発生します。
  • 実装例

    public static void ShowAllReceiptsRegistrationView()
    {
        SMCloudServices.SetRegistrationConfigFilePath(path);
    
        Window ownerWindow = Util.GetMainWindow();
    
        SMCloudServices.ShowRegistrationView(ownerWindow);
    
        // SMCloudServices.ShowRegistrationView();
    }
    

    AllReceiptSamplePage.xaml.csを参照ください。

5.1.2. IsRegistered

アプリケーションがスター精密クラウドサービスに登録されているか確認します。

  • 宣言

    public static bool IsRegistered()
    
  • 引数

    なし

  • 戻り値

    説明
    結果
    true ... 登録されている
    false ... 登録されていない
    bool
  • 実装例

    private static bool CheckIsDeviceRegisteredInStarCloudServices()
    {
        SMCloudServices.SetRegistrationConfigFilePath(@"C:\Users\user\AppData\Roaming\StarMicronics");
    
        return SMCloudServices.IsRegistered();
    }
    

    AllReceiptSamplePage.xaml.csを参照ください。

5.1.3. SetRegistrationConfigFilePath

スター精密クラウドサービス登録情報を保存する場所を設定します。

  • 宣言

    public static bool SetRegistrationConfigFilePath(string path)
    
  • 引数

    名称 説明
    path スター精密クラウドサービス登録情報の保存場所 string
  • 戻り値

    説明
    true ... 成功
    false ... 失敗
    bool
  • 実装例

    private static bool CheckIsDeviceRegisteredInStarCloudServices()
    {
        SMCloudServices.SetRegistrationConfigFilePath(@"C:\Users\user\AppData\Roaming\StarMicronics");
    
        return SMCloudServices.IsRegistered();
    }
    

    AllReceiptSamplePage.xaml.csを参照ください。

5.1.4. GetRegistrationConfigFilePath

スター精密クラウドサービス登録情報の保存する場所を取得します。

  • 宣言

    public static string GetRegistrationConfigFilePath()
    
  • 引数

    なし

  • 戻り値

    説明
    スター精密クラウドサービス登録情報の保存場所 string
  • 実装例

    public static void DeleteRegistrationConfigFile()
    {
        string registratioConfignFilePath = SMCloudServices.GetRegistrationConfigFilePath();
    
        try
        {
            File.Delete(registratioConfignFilePath);
        }
        catch (Exception) {}
    }
    

    AllReceiptSamplePage.xaml.csを参照ください。

5.1.5. GetSMCloudServicesVersion

SMCloudServicesSolutionライブラリのバージョンを取得します。

  • 宣言

    public static string GetSMCloudServicesVersion()
    
  • 引数

    なし

  • 戻り値

    説明
    SMCloudServicesSolutionライブラリのバージョン string
  • 実装例

    public static void ShowLibraryVersion()
    {
        string starIOVersion = GetStarIOVersion();
        string starIOExtVersion = GetStarIOExtVersion();
        string smCoudServicesVersion = GetSMCloudServicesVersion();
    }
    

    MainPage.xaml.csを参照ください。

5.1.6. RegisteredEvent

スター精密クラウドサービス登録ビューを閉じたときに発生します。

  • 宣言

    public static event EventHandler<RegisteredResult> RegisterEvent
    
  • 実装例

    public static void AddAllReceiptsFunctionEvent()
    {
        SMCloudServices.RegisteredEvent += AllReceiptsFunctions.SMCloudServices_RegisterResultEvent;
    }
    
    public static void SMCloudServices_RegisterResultEvent(object sender, RegisteredResult e)
    {
        bool isRegistered = e.IsRegistered;
    }
    

    AllReceiptSamplePage.xaml.cs / AllReceiptsFunction.csを参照ください。

5.2. RegisteredResult

登録結果取得クラスです。

  • 宣言

    public class RegisteredResult : EventArgs
    
  • コンストラクタ

    なし

  • プロパティ

    名称 説明
    IsRegistered スター精密クラウドサービスへの登録結果を取得します。

5.2.1. IsRegistered

スター精密クラウドサービスへの登録結果を取得します。

  • 宣言

    public bool IsRegistered { get; }