Xtreme Suite Pro是為Windows開(kāi)發(fā)人員提供的用于ActiveX COM的用戶(hù)界面套包，創(chuàng)建包含完整的高度可自定義的用戶(hù)界面組件（包括Visual Studio樣式對(duì)接窗格和Office樣式功能區(qū)，工具欄和菜單），以使您的應(yīng)用程序具有現(xiàn)代外觀。該套包提供了Windows開(kāi)發(fā)人員所需要的11種最受歡迎的控件，包括Command Bars、Controls、Chart Pro、Calendar、Docking Pane、Property Grid、Report Control、Shortcut Bar、Syntax Edit、Skin Framework 和 Task Panel。

點(diǎn)擊下載Xtreme Suite Pro最新試用版

Codejock ActiveX 組件是獨(dú)立的 .OCX 文件，必須在將使用它們的目標(biāo)計(jì)算機(jī)上復(fù)制和注冊(cè)。一個(gè)組件 (.OCX) 文件公開(kāi)了一組使用它提供的控件所必需的類(lèi)和接口。這些控件可以在任何開(kāi)發(fā)環(huán)境和任何支持 ActiveX 技術(shù)的編程語(yǔ)言中使用。

使用 ActiveX 組件和相關(guān)語(yǔ)言相關(guān)問(wèn)題的方法超出了本文的范圍，因?yàn)樗鼘?duì)于每種編程語(yǔ)言都是獨(dú)一無(wú)二的。假定開(kāi)發(fā)人員熟悉與他選擇的編程語(yǔ)言相關(guān)的 ActiveX 概念和最佳實(shí)踐。

本文解釋了以下相關(guān)問(wèn)題：

1. 選擇正確的組件配置
2. 注冊(cè)組件
3. 版本控制組件
4. 許可組件
5. 已知問(wèn)題和解決方法

選擇正確的組件配置

每個(gè) Codejock ActiveX 組件都有 3 種配置：

1. 32 位 ANSI
2. 32 位 Unicode
3. 64 位 Unicode

組件文件名反映其配置，例如：

• Codejock.ChartPro.v18.0.1.ocx - 32 位 ANSI
• Codejock.ChartPro.Unicode.v18.0.1.ocx - 32 位 Unicode
• Codejock.ChartPro.Unicode.x64.v18.0.1.ocx - 64 位 Unicode

選擇與您的主機(jī)應(yīng)用程序兼容的正確配置很重要，因?yàn)?Windows 不允許在一個(gè)地址空間中混合模塊的位數(shù)，舊的編程語(yǔ)言不支持 Unicode 字符集。

可能的安裝選項(xiàng)是：

1. 僅當(dāng)您的應(yīng)用程序不支持 Unicode 時(shí)才安裝 32 位 ANSI 組件，例如啟用多字節(jié)字符集的 Visual Basic 6 應(yīng)用程序或 32 位 C++ 應(yīng)用程序。
2. 僅當(dāng)您的應(yīng)用程序支持 Unicode 時(shí)才安裝 32 位 Unicode 組件，例如具有 x86 TargetCPU 的C# 應(yīng)用程序、32 位 Microsoft Office 應(yīng)用程序或啟用 Unicode 字符集的 32 位 C++ 應(yīng)用程序
3. 如果您的應(yīng)用程序是 64 位應(yīng)用程序，則同時(shí)使用 32 位和 64 位 Unicode 組件，例如具有 x64 或AnyCPU TargetCPU 的C# 應(yīng)用程序、64 位 Microsoft Office 應(yīng)用程序或啟用了 Unicode 字符集的 64 位 C++ 應(yīng)用程序。即使不使用 32 位 Unicode 組件，安裝 32 位 Unicode 組件也
   很重要，因?yàn)?Windows 操作系統(tǒng)要求所有 64 位 COM 對(duì)象都安裝相應(yīng)的 32 位組件。
4. 還可以安裝三種配置以涵蓋所有可能的用例。

組件可以安裝到至少對(duì)安裝組件的所有潛在用戶(hù)都是只讀訪(fǎng)問(wèn)的任何位置。

注冊(cè)組件

僅將組件文件復(fù)制到目標(biāo)位置才能使用它是不夠的，它們必須注冊(cè)并包含許可證（在下一節(jié)中描述）。即使在開(kāi)發(fā)機(jī)器上安裝 SuitePro 或獨(dú)立的 ActiveX 組件后，也必須在使用組件之前注冊(cè)必要的配置。

可以使用安裝包中包含的Registrator工具在開(kāi)發(fā)機(jī)器上注冊(cè)組件。通常可以在以下位置找到它：%ProgramFiles(x86)%\Codejock Software\ActiveX\Xtreme SuitePro ActiveX v18.0.1\Bin\Registrator.exe

如果組件與應(yīng)用程序一起分發(fā)，則必須在應(yīng)用程序安裝期間注冊(cè)每個(gè) .OCX 模塊。通常，這可以通過(guò)使用以管理員身份執(zhí)行的%SystemRoot%\System32\regsvr32.exe工具來(lái)實(shí)現(xiàn)，例如使用此命令行進(jìn)行靜默日歷注冊(cè)：

regsvr32.exe /s Codejock.Calendar.v18.0.1.OCX

或此命令行用于靜默注銷(xiāo)日歷組件：

regsvr32.exe /s /u Codejock.Calendar.v18.0.1.OCX

重要的是要了解應(yīng)該注冊(cè)組件的目標(biāo)機(jī)器可能已經(jīng)注冊(cè)了相同版本的 Codejock 組件。雖然重新注冊(cè)相同版本的組件沒(méi)有壞處，但如果使用 Codejock 組件的應(yīng)用程序被卸載，取消注冊(cè)組件可能會(huì)破壞依賴(lài)于這些組件的其他應(yīng)用程序。有兩種方法可以解決此問(wèn)題：

1. 在應(yīng)用程序卸載期間保持 Codejock 組件完整。這會(huì)造成污染，但無(wú)需額外的努力即可提供最佳的穩(wěn)定性保證。
2. 向您的應(yīng)用程序添加引導(dǎo)程序，以確保在執(zhí)行應(yīng)用程序之前正確注冊(cè)必要的組件。如果檢測(cè)到未注冊(cè)的組件，引導(dǎo)程序會(huì)觸發(fā)重新安裝流程。

如果需要手動(dòng)檢查 Codejock 組件注冊(cè)，可以使用來(lái)自 Windows SDK 的標(biāo)準(zhǔn) OLE 查看工具：

版本控制組件

每個(gè) ActiveX 組件都有一組唯一的類(lèi)、接口和類(lèi)型庫(kù) ID，與它注冊(cè)到系統(tǒng)相關(guān)。為了避免版本沖突，所有 Codejock 組件都會(huì)在每個(gè)新版本中重新生成它們的 ID。

雖然這確保了相同組件但不同版本的 2 個(gè)或多個(gè)安裝可以獨(dú)立地共存于同一系統(tǒng)中，但它使開(kāi)發(fā)機(jī)器上的組件升級(jí)過(guò)程比僅安裝較新版本要復(fù)雜一些。根據(jù)開(kāi)發(fā)環(huán)境和編程語(yǔ)言，這種情況可以通過(guò)不同的方式和不同的副作用來(lái)解決。

例如，項(xiàng)目加載期間的 Visual Basic 6 IDE 可以確定引用的組件有可用的更新版本，并提示自動(dòng)升級(jí)現(xiàn)有組件。不幸的是，Microsoft Office 在 ActiveX 組件升級(jí)方面不如 Visual Basic 6 IDE 靈活，它不會(huì)提示自動(dòng)升級(jí)，而是僅使用當(dāng)前組件版本，或者如果控件不存在則根本不實(shí)例化控件，即使有更新的版本可用。在這種情況下，升級(jí)控件的唯一方法是刪除舊控件并插入新控件并重新存儲(chǔ)以前的屬性。

許可組件

所有 Codejock ActiveX 組件都需要有有效的許可證才能運(yùn)行。ActiveX 許可證不應(yīng)與付費(fèi)訂閱混淆，它只是一個(gè)小的文本文件 .LIC，每個(gè) .OCX 文件必須與 .OCX 文件一起分發(fā)，這并不意味著任何額外費(fèi)用。

當(dāng)您將 Codejock 組件與您的應(yīng)用程序一起分發(fā)時(shí)，有兩種方式可以包含許可證：

1. 作為單獨(dú)的 .LIC 文件（最好）
2. 嵌入到應(yīng)用程序中

將許可證作為單獨(dú)的 .LIC 文件分發(fā)

這是分發(fā)許可證的一種更可取且最簡(jiǎn)單的方法。所需要做的只是將每個(gè) .OCX 組件的 .LIC 文件復(fù)制到同一位置。使用此方法可確保組件獲取許可證（如果存在）。與將許可證嵌入應(yīng)用程序不同，不會(huì)出現(xiàn)跨模塊問(wèn)題。

例如，您將適用于 32 位和 64 位平臺(tái)的 Codejock Calendar ActiveX 組件作為應(yīng)用程序的一部分安裝到%ProgramFiles(x86)%\<YourCompanyName>\<YourApplicationName>\bin目錄，則 bin 目錄應(yīng)包含以下文件：

• Codejock.Calendar.v18.0.1.OCX
• Codejock.Calendar.Unicode.v18.0.1.OCX
• Codejock.Calendar.Unicode.x64.v18.0.1.OCX
• Codejock.Calendar.v18.0.1.LIC

如果要包含 CommandBars 組件，還需要將Codejock.CommandBars.v18.0.1.LIC復(fù)制到同一位置。

分發(fā)嵌入應(yīng)用程序的許可證

在某些情況下，分發(fā)單獨(dú)的 .LIC 文件是不可能的，例如，當(dāng)您為 Web 瀏覽器或任何其他類(lèi)型的遠(yuǎn)程客戶(hù)端開(kāi)發(fā) ActiveX 組件時(shí)。在這種情況下，唯一的選擇是將許可證文本嵌入到應(yīng)用程序中。

在跨模塊場(chǎng)景中，這種方法應(yīng)該非常謹(jǐn)慎地使用，并且容易出現(xiàn)意外行為，因?yàn)椴煌?環(huán)境以不同的方式管理此類(lèi)場(chǎng)景。例如，如果您開(kāi)發(fā)的 Visual Basic 應(yīng)用程序不使用報(bào)表控件，而是使用另一個(gè)使用報(bào)表控件的自定義控件，則報(bào)表控件的許可證必須從宿主應(yīng)用程序設(shè)置，而不是從自定義控制。在這種情況下，建議將許可證作為單獨(dú)的 .LIC 文件分發(fā)。

它的工作方式是，每個(gè)組件都公開(kāi)自己的GlobalSettings具有 stringLicense屬性的類(lèi)。此屬性必須設(shè)置為對(duì)應(yīng) .LIC 文件的前 3 個(gè)字符串的逐字值，直到第一個(gè)空行，包括所有空格和新行。使用 CRLF 作為新行分隔符（0Dh、0Ah字節(jié)序列或"\r\n"轉(zhuǎn)義序列）很重要，因?yàn)樗?.LIC 文件中使用。

必須在應(yīng)用程序初始化流程中盡早分配該屬性。對(duì)于 Visual Basic，它可以是 的開(kāi)頭Form_Initialize，對(duì)于 .NET 應(yīng)用程序，它可以是主窗口構(gòu)造函數(shù)的開(kāi)頭。在對(duì)組件進(jìn)行任何其他顯式或隱式調(diào)用之前分配此屬性很重要。

以下是如何執(zhí)行此操作的示例：

Private Sub Form_Initialize()

    CommandBarsGlobalSettings.License = _
    "CommandBars Control Copyright (c) 1998-2017 Codejock Software" & vbCrLf & _
    "PRODUCT-ID: Codejock.CommandBars.ActiveX.v18.0" & vbCrLf & _
    "VALIDATE-CODE: XXX-XXX-XXX-XXX"

End Sub

已知問(wèn)題和解決方法

更新 .NET 引用

在某些情況下，當(dāng)引用 Codejock ActiveX 組件的項(xiàng)目在其創(chuàng)建位置以外的計(jì)算機(jī)上打開(kāi)時(shí)，或者項(xiàng)目是使用舊版本的 Visual Studio 創(chuàng)建的，或者如果只有較新版本的組件可用，則形成初始化流程最后可能會(huì)因 COM 異常而失敗。可能有多種原因，最常見(jiàn)的一個(gè)是由另一個(gè) Visual Studio 實(shí)例為 Codejock ActiveX 組件創(chuàng)建的互操作程序集與可用組件不匹配。以下步驟可能有助于解決此問(wèn)題：

1. 確保安裝并注冊(cè)了正確的組件，并且注冊(cè)的組件配置與項(xiàng)目屬性中的TargetCPU匹配（請(qǐng)參閱本文開(kāi)頭的選擇正確的組件配置和注冊(cè)組件）。
2. 打開(kāi)您的項(xiàng)目并關(guān)閉所有窗口，尤其是資源和表單設(shè)計(jì)器。
3. 打開(kāi)項(xiàng)目引用并刪除每個(gè) Codejock 組件的 2 個(gè)引用，例如，如果您的項(xiàng)目?jī)H使用 CommandBars，您將有 2 個(gè)相關(guān)引用：
   • XtremeCommandBars - CommandBars 組件的互操作程序集
   • AxXtremeCommandBars - CommandBars 組件的 ActiveX 控件庫(kù)
4. 保存并重新構(gòu)建項(xiàng)目。預(yù)計(jì)會(huì)因某些或許多錯(cuò)誤而失敗。
5. 打開(kāi) Visual Studio 工具箱，在任何空白處單擊鼠標(biāo)右鍵，然后從彈出菜單中選擇“選擇項(xiàng)目”。
6. 轉(zhuǎn)到 COM 組件選項(xiàng)卡并在已刪除類(lèi)型庫(kù)的控件旁邊設(shè)置復(fù)選標(biāo)記，例如在 Xtreme CommandBars Control 旁邊設(shè)置復(fù)選標(biāo)記，確保其路徑指向正確的位置，然后按 OK。您應(yīng)該會(huì)看到為每個(gè)選定控件添加的新工具箱按鈕。
7. 轉(zhuǎn)到解決方案資源管理器并向項(xiàng)目添加一個(gè)新的臨時(shí)表單，名稱(chēng)無(wú)關(guān)緊要。
8. 將每個(gè)刪除的組件引用一個(gè)控件放到工具箱中的臨時(shí)表單上。當(dāng)您放下時(shí)，您會(huì)看到自動(dòng)生成新引用并將其添加到您的項(xiàng)目中。這可能是一個(gè)耗時(shí)的過(guò)程，具體取決于您的硬件和操作系統(tǒng)性能。
9. 保存項(xiàng)目并重新構(gòu)建，這次應(yīng)該沒(méi)有與之前刪除的引用相關(guān)的編譯錯(cuò)誤。如果您確實(shí)看到由新組件引起的新編譯錯(cuò)誤，則接口可能已更改，或者在極少數(shù)情況下 Visual Studio 修復(fù)了引用組件的公共屬性或方法名稱(chēng)，例如，它可以O(shè)cxState為名為 的屬性生成名稱(chēng)State。
10. 在調(diào)試器下運(yùn)行項(xiàng)目以確保表單初始化不再失敗。
11. 刪除之前創(chuàng)建的臨時(shí)表單。