如何调用 Microstation 的消息管理器

发表于 2022-05-12 分类于 Bentley ， Develop ，消息中心本文字数： 3.3k 阅读时长 ≈ 3 分钟

在进行Bentley二次开发的时候，通常我们需要向用户输出一些信息，比如操作的提示，错误的提示等等，本文特对这些方式进行总结，方便下次随心所欲地使用。

通知管理器

通过使用 NotificationManager 向用户推送消息。可以用此类来生成提示、错误消息和警报对话框。

DLL 名称	命名空间	类名
Bentley.DgnPlatformNET.dll	Bentley.DgnPlatformNET	NotificationManager

源码注解


//打开消息弹窗
public static MessageBoxValue OpenMessageBox(MessageBoxType mbType, string message, MessageBoxIconType icon);
//向MS的底部通知栏写入提示
public static StatusInt OutputMessage(NotifyMessageDetails message);
public static void OutputPrompt(string prompt);
//设置一个标志来分配（value==true时）事件，以便在执行费时算法时，刷新界面，从而不卡顿。
public static void SetDispatchEvents(bool value);

public enum MessageBoxType
{
    YesNo = -121,
    LargeOk = -119,
    YesNoCancel = -113,
    MediumAlert = -112,
    Ok = -97,
    OkCancel = -13,
    None = 0
}
public enum MessageBoxIconType
{
    NoSymbol = 0,
    Information = 1,
    Question = 2,
    Warning = 3,
    Critical = 4
}
public enum MessageBoxValue
{
    None = 0,
    Apply = 1,
    Reset = 2,
    Ok = 3,
    Cancel = 4,
    Default = 5,
    Yes = 6,
    No = 7,
    Retry = 8,
    Stop = 9,
    Help = 10,
    YesToAll = 11,
    NoToAll = 12
}

使用

OpenMessageBox方法

private void NotificationManagerOpenMessageBox()
{  
    NotificationManager.OpenMessageBox(NotificationManager.MessageBoxType.MediumAlert, "Medium alert",NotificationManager.MessageBoxIconType.Warning);
}

OutputMessage方法

private void NotificationManagerOutputMessage()
{
    OutputMessagePriority outputMessagePriority = OutputMessagePriority.Information;
    string briefMsg = "this is a brief msg";
    string detailMsg = "this is a detail msg";
    NotifyTextAttributes notifyTextAttributes = NotifyTextAttributes.AlwaysBeveled;
    NotifyMessageDetails notifyMessageDetails = new NotifyMessageDetails(outputMessagePriority,briefMsg,detailMsg,notifyTextAttributes,OutputMessageAlert.Balloon);
    NotificationManager.OutputMessage(notifyMessageDetails);    
}

OutputPrompt方法

private void NotificationManagerOutputPrompt()
{
    NotificationManager.OutputPrompt("this is ouput prompt");
}

消息中心（MessageCenter）

在 Bentley.MstnPlatformNET 中也存在与消息管理器一样的类以供调用向用户传递消息。

DLL 名称	命名空间	类名
ustation.dll	Bentley.MstnPlatformNET	MessageCenter

// 其内部代码如下

public class MessageCenter
{
    public static MessageCenter Instance { get; }
    public string StatusWarning { set; }
    public string StatusMessage { set; }
    public string StatusPrompt { set; }
    public string StatusCommand { get; set; }

    public static string GetStringFromMessageListResource(int listId, int stringId);
    public void ShowDebugMessage(string briefMessage, string detailedMessage, bool openAlertBox);
    public void ShowDebugMessage(string briefMessage, string detailedMessage, MessageAlert alertType);
    public void ShowErrorMessage(string briefMessage, string detailedMessage, bool openAlertBox);
    public void ShowErrorMessage(string briefMessage, string detailedMessage, MessageAlert alertType);
    public void ShowInfoMessage(string briefMessage, string detailedMessage, bool openAlertBox);
    public void ShowInfoMessage(string briefMessage, string detailedMessage, MessageAlert alertType);
    public void ShowMessage(MessageType messageType, string briefMessage, string detailedMessage, MessageAlert alertType);
}