通過Localizer對象本地化WinForms控件

---

立即下載DevExpress WinForms

DevExpress WinForms控件通過 Localizer對象獲取其UI元素的默認文本(例如，Data Grid使用, PivotGrid使用等)，以下方法允許您使用本地化程序將默認資源替換為新的文本：

• 為特定控件/庫創建自定義本地化器
• 使用全局XtraLocalizer類，它允許您為所有DevExpress .NET控件提供本地化文本。

提示：有些控件只有附屬程序集才能翻譯(例如，XtraReports中的Search對話框)，我們建議您使用附屬程序集來翻譯應用程序。另外，請注意，如果使用自定義本地化程序，則會忽略附屬程序集。

自定義本地化

使用自定義本地化程序提供本地化字符串，如下所示。

• 創建與特定控件/庫對應的本地化程序類的后代，下面列出了默認的本地化程序類。
• 覆蓋GetLocalizedString方法來返回特定字符串資源標識符的本地化字符串，或者您可以覆蓋PopulateStringTable方法來轉換資源。
• 將本地化程序類的實例分配給您繼承的本地化器類的靜態Active屬性。

示例

下面的例子演示了如何使用本地化程序將字符串翻譯成 German：

本例為Data Grid UI和Editors UI創建本地化程序，這些本地化程序是GridLocalizer和類的后代。

C#：

using DevExpress.XtraEditors.Controls;
using DevExpress.XtraGrid.Localization;

public class GermanGridLocalizer : GridLocalizer {
public override string Language { get { return "Deutsch"; } }
public override string GetLocalizedString(GridStringId id) {
string ret = "";
switch (id) {
// ...
case GridStringId.GridGroupPanelText: return "Ziehen Sie eine Spaltenüberschrift in diesen Bereich, um nach dieser zu gruppieren";
case GridStringId.MenuColumnClearSorting: return "Sortierung entfernen";
case GridStringId.MenuGroupPanelHide: return "Gruppierungsfeld ausblenden";
case GridStringId.MenuColumnRemoveColumn: return "Spalte entfernen";
case GridStringId.MenuColumnFilterEditor: return "Filter &bearbeiten";
case GridStringId.MenuColumnFindFilterShow: return "Suche einblenden";
case GridStringId.MenuColumnAutoFilterRowShow: return "Zeige Auto Filterzeile";
case GridStringId.MenuColumnSortAscending: return "Aufsteigend sortieren";
case GridStringId.MenuColumnSortDescending: return "Absteigend sortieren";
case GridStringId.MenuColumnGroup: return "Gruppieren fur dieses Feld";
case GridStringId.MenuColumnUnGroup: return "Gruppierung aufheben";
case GridStringId.MenuColumnColumnCustomization: return "Laufzeit benutzerdefinierte Spalte";
case GridStringId.MenuColumnBestFit: return "Optimale Breite";
case GridStringId.MenuColumnFilter: return "Kann gruppieren";
case GridStringId.MenuColumnClearFilter: return "Filter aufheben";
case GridStringId.MenuColumnBestFitAllColumns: return "Optimale Breite (alle Spalten)";
// ...
default:
ret = base.GetLocalizedString(id);
break;
}
return ret;
}
}

public class GermanEditorsLocalizer : Localizer {
public override string Language { get { return "Deutsch"; }}
public override string GetLocalizedString(StringId id) {
switch(id) {
// ...
case StringId.NavigatorTextStringFormat: return "Zeile {0} von {1}";
case StringId.PictureEditMenuCut: return "Ausschneiden";
case StringId.PictureEditMenuCopy: return "Kopieren";
case StringId.PictureEditMenuPaste: return "Einfugen";
case StringId.PictureEditMenuDelete: return "Loschen";
case StringId.PictureEditMenuLoad: return "Laden";
case StringId.PictureEditMenuSave: return "Speichern";
// ...
}
return base.GetLocalizedString(id);
}
}

VB.NET：

Imports DevExpress.XtraEditors.Controls
Imports DevExpress.XtraGrid.Localization

Public Class GermanGridLocalizer
Inherits GridLocalizer
Public Overrides ReadOnly Property Language() As String
Get
Return "Deutsch"
End Get
End Property
Public Overrides Function GetLocalizedString(id As GridStringId) As String
Dim ret As String = ""
Select Case id
' ...
Case GridStringId.GridGroupPanelText
Return "Ziehen Sie eine Spaltenüberschrift in diesen Bereich, um nach dieser zu gruppieren"
Case GridStringId.MenuColumnClearSorting
Return "Sortierung entfernen"
Case GridStringId.MenuGroupPanelHide
Return "Gruppierungsfeld ausblenden"
Case GridStringId.MenuColumnRemoveColumn
Return "Spalte entfernen"
Case GridStringId.MenuColumnFilterEditor
Return "Filter &bearbeiten"
Case GridStringId.MenuColumnFindFilterShow
Return "Suche einblenden"
Case GridStringId.MenuColumnAutoFilterRowShow
Return "Zeige Auto Filterzeile"
Case GridStringId.MenuColumnSortAscending
Return "Aufsteigend sortieren"
Case GridStringId.MenuColumnSortDescending
Return "Absteigend sortieren"
Case GridStringId.MenuColumnGroup
Return "Gruppieren fur dieses Feld"
Case GridStringId.MenuColumnUnGroup
Return "Gruppierung aufheben"
Case GridStringId.MenuColumnColumnCustomization
Return "Laufzeit benutzerdefinierte Spalte"
Case GridStringId.MenuColumnBestFit
Return "Optimale Breite"
Case GridStringId.MenuColumnFilter
Return "Kann gruppieren"
Case GridStringId.MenuColumnClearFilter
Return "Filter aufheben"
Case GridStringId.MenuColumnBestFitAllColumns
Return "Optimale Breite (alle Spalten)"
Case Else
' ...
ret = MyBase.GetLocalizedString(id)
Exit Select
End Select
Return ret
End Function
End Class

Public Class GermanEditorsLocalizer
Inherits Localizer
Public Overrides ReadOnly Property Language() As String
Get
Return "Deutsch"
End Get
End Property

Public Overrides Function GetLocalizedString(ByVal id As StringId) As String
Select Case id
' ...
Case StringId.NavigatorTextStringFormat : Return "Zeile {0} von {1}"
Case StringId.PictureEditMenuCut : Return "Ausschneiden"
Case StringId.PictureEditMenuCopy : Return "Kopieren"
Case StringId.PictureEditMenuPaste : Return "Einfugen"
Case StringId.PictureEditMenuDelete : Return "Loschen"
Case StringId.PictureEditMenuLoad : Return "Laden"
Case StringId.PictureEditMenuSave : Return "Speichern"
' ...
End Select
Return MyBase.GetLocalizedString(id)
End Function
End Class

要使用這些本地化程序，分別將GermanGridLocalizer和GermanEditorsLocalizer類的實例分配給GridLocalizer.Active和Localizer.Active屬性。

C#：

public Form1() {
GridLocalizer.Active = new GermanGridLocalizer();
Localizer.Active = new GermanEditorsLocalizer();
InitializeComponent();
}

VB.NET：

Public Sub Form1()
GridLocalizer.Active = New GermanGridLocalizer()
Localizer.Active = New GermanEditorsLocalizer()
InitializeComponent()
End Sub

默認本地化程序

下表列出了DevExpress WinForms產品的默認本地化程序類和相應的資源字符串標識符：

XtraLocalizer

靜態 XtraLocalizer.QueryLocalizedString 事件允許您為應用程序中的所有DevExpress控件提供本地化字符串，如果應用程序使用來自多個庫的控件(例如，數據網格、編輯器、圖表和Pivot網格)，則在這些控件請求本地化字符串時會觸發QueryLocalizedString事件。

提示：QueryLocalizedString事件處理程序應該是表單的方法，否則垃圾收集器可以收集對委托的引用。

使用e.StringID事件參數來標識控件當前處理的字符串，此屬性返回控件的資源字符串枚舉的值(請參見上面的表)，事件參數來標識控件當前處理的字符串，此屬性返回控件的資源字符串枚舉的值(請參見上面的表)。

示例

下面的例子處理 XtraLocalizer.QueryLocalizedString 事件，為數據網格UI和編輯器UI本地化特定的字符串：

C#：

using DevExpress.Utils.Localization;
using DevExpress.XtraEditors.Controls;
using DevExpress.XtraGrid.Localization;

private void Form1_Load(object sender, EventArgs e) {
XtraLocalizer.QueryLocalizedString += XtraLocalizer_QueryLocalizedString;
}

private void XtraLocalizer_QueryLocalizedString(object sender, XtraLocalizer.QueryLocalizedStringEventArgs e) {
// Data Grid's UI
if (e.StringIDType == typeof(GridStringId)) {
if ((GridStringId)e.StringID == GridStringId.GridGroupPanelText)
e.Value = "Gruppenregion";
}
// Editors UI
if (e.StringIDType == typeof(StringId)) {
if ((StringId)e.StringID == StringId.PictureEditMenuCut)
e.Value = "Ausschneiden";
if ((StringId)e.StringID == StringId.PictureEditMenuCopy)
e.Value = "Kopieren";
if ((StringId)e.StringID == StringId.PictureEditMenuPaste)
e.Value = "Einfugen";
}
}

VB.NET：

Imports DevExpress.Utils.Localization
Imports DevExpress.XtraEditors.Controls
Imports DevExpress.XtraGrid.Localization

Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
AddHandler XtraLocalizer.QueryLocalizedString, AddressOf XtraLocalizer_QueryLocalizedString
End Sub

Private Sub XtraLocalizer_QueryLocalizedString(ByVal sender As Object, ByVal e As XtraLocalizer.QueryLocalizedStringEventArgs)
' Data Grid's UI
If e.StringIDType Is GetType(GridStringId) Then
If CType(e.StringID, GridStringId) = GridStringId.GridGroupPanelText Then
e.Value = "Gruppenregion"
End If
End If
' Editors UI
If e.StringIDType Is GetType(StringId) Then
If CType(e.StringID, StringId) = StringId.PictureEditMenuCut Then
e.Value = "Ausschneiden"
End If
If CType(e.StringID, StringId) = StringId.PictureEditMenuCopy Then
e.Value = "Kopieren"
End If
If CType(e.StringID, StringId) = StringId.PictureEditMenuPaste Then
e.Value = "Einfugen"
End If
End If
End Sub