2007-10-05 DATABITEN Version 2006.1/10.1.2 Visual Plus 2006 Toolbox till Borland Developer Studio 2006 ============================================================ Systemkrav installation ======================== - Windows 2000,XP,2003,Vista - Borland Developer Studio 2006 med Update Pack 2 (BDS2006 säljs också under namnen Delphi 2006 resp. C++Builder 2006) - Turbo Delphi Win32, Turbo Delphi .NET, Turbo C++ OBS! Visual Plus 2006 Toolbox fungerar INTE med CodeGear RAD Studio 2007, Delphi 2007 med Update 3 eller C++Builder 2007 med Update 3. Om du vill använda Visual Plus Toolbox tillsammans med RAD Studio 2007 (Delphi 2007, C++Builder 2007) rekommenderar vi istället Visual Plus 2007 Toolbox. OBS! Visual Plus 2006 Toolbox fungerar inte heller med Trial-versioner av BDS 2006 eftersom dessa använder ett specialformat för kompilerade DCU-filer. Med Explorer-versioner av Turbo kan man inte installera VIP2006- komponenterna under Tool Palette, men komponentinstanser kan skapas direkt i koden (tex VPCalendar1:= TVPCalendar.Create(Application). Installation ============ Översikt -------- När du installerar Visual Plus Toolbox, installeras toolboxen först som en testversion/trial och du kan direkt komma igång och provköra medföljande Visual Plus-exempel eller testa Visual Plus i egna projekt. När du kör dessa exempel och applikationer visas ett meddelande med information om att du använder en testversion testversion. Med en licensnyckel kan du öppna upp toolboxen för kommersiell användning. Du behöver då inte ominstallera Visual Plus, utan det räcker med att installera licensnyckeln och därefter är Visual Plus klar att använda som en komplett version. Komplettera dina applikationer med VIP.pas, VIP.cpp resp VIP.cs och bygg (=build) sedan om alla applikationer som använder Visual Plus. Du hittar också en illustrerad version av installations- anvisningarna i första kapitlet i Visual Plus-handböckerna. Se VIP2006Delphi.pdf resp VIP2006BCB.pdf. 1. Hämta installationsfilerna ============================= Börja installationen med att ladda ner följande filer från www.databiten.se, (klicka där på Visual Plus i menyn): VIP2006README.txt Denna fil VIP2006Install.exe Installationsfil med Visual Plus 2006 Toolbox, programexempel och dokumentation på PDF-format Du kan läsa och söka i dokumentation on-line med gratis Adobe Reader 6, 7 eller 8 (ver 8 rekommenderas). Hämtas från www.adobe.com. Du kan också läsa/ladda ner licensvillkoren för Visual Plus 2006. Bortsett från licensvillkor och installation av licensnyckel, är installationsstegen och filerna desamma för installation av Visual Plus som testversion (Visual Plus 2006 Toolbox Trial) eller "skarp" version. 2. Äldre versioner av Visual Plus Toolbox ========================================= Inget hindrar att du behåller äldre Delphi-versioner (Delphi 2005, 8, 7, 6, etc), tillsammans med dito äldre Visual Plus-versioner. Visual Plus 2006 installerar sig i en egen katalog och stör inte dessa äldre versioner. OBS! Om du däremot har en äldre version av Visual Plus 2006 Toolbox installerad, måste du först avregistrera och avinstallera denna, innan du installerar en senare version. Se under rubriken "Avinstallera Visual Plus 2006 Toolbox" längre ned i denna fil. 3. Kör installationsprogrammet VIP2006Install.exe ================================================= Visual Plus 2006 Toolbox kan installeras under Windows 2000, 2003, XP samt Vista. Du måste dock vara inloggad med tillräckliga användarrättigheter (administratör eller "Power User"). Om installationen görs av en administratör, så installeras Visual Plus 2006 för alla användare, annars bara för den inloggade användaren. - Kontrollera först att BDS 2006 (Delphi, C++Builder), Turbo, etc. inte körs under installationen. - Starta installationsprogrammet VIP2006Install.exe. Med VIP2006Install.exe installerar du: - Visual Plus-komponenter och enheter/units - Programexempel, inkl MultiDoc - en flikad webbläsare, med källkod i Delphi. - Visual Plus 2006 Toolbox-dokumentation på PDF-format Installationsprogrammet föreslår att du installerar Visual Plus som en underkatalog till Windows Program-katalog (t ex C:\Program\DATABITEN\VIP2006, eller C:\Program Files\DATABITEN\VIP2006). Om du vill, kan du välja att installera Visual Plus i en annan katalog (men välj inte samma katalog som en eventuell tidigare Visual Plus-version). 4. Registrering av Visual Plus-komponenterna i utvecklingsmiljön ================================================================ När installationsprogrammet är klart startar VIP2006Reg.exe, som registrerar Visual Plus-komponenterna i BDS 2006 (Delphi 2006, C++Builder 2006) och Turbo. Om .NET 1.1 är installerat registreras dessutom Visual Plus-assemblies i .NET 1.1 Global Assembly Cache (GAC) (.NET 1.1 används inte av Delphi 2007) VIP2006Reg registrerar bara Visual Plus-komponenterna i utvecklingsmiljön för den inloggade användaren. Om du vill registrera komponenterna för en annan användare, loggar du först in som denne användare och kör sedan VIP2006Reg.exe igen. Om du får problem med registrering av Visual Plus-komponenterna i BDS eller Visual Plus assemblies i GAC, kan du när som helst köra VIP2006Reg.exe på nytt. Programmet finns i Visual Plus 2006 rotkatalog, vanligen C:\Program\DATABITEN\VIP2006 eller C:\Program Files\DATABITEN\VIP2006. Du kan alternativt registrera komponenter och assemblies på egen hand. 5.Installera licensnyckel ========================= När du köper en komplett Visual Plus 2006 Toolbox, får du en personlig licensnyckel, som vanligtvis levereras via epost. Fullborda Visual Plus-installationen genom att skapa personliga, licensmärkta versioner av VIP.pas (Delphi Object Pascal), VIP.cpp (C++Builder) resp VIP.cs (C#). - Logga in som administratör eller "power user". Starta applikationen "VIP2006Serial.exe" som du hittar i "Visual Plus 2006" programfolder (eller starta direkt från ..\VIP2006-katalogen). Följ sedan instruktionerna i VIP2006Serial. VIP.pas, VIP.cpp och VIP.cs placeras i katalogen ..\VIP2006\lib direkt under Windows gemensamma, delade katalog: ..\Shared Documents\VIP2006\lib (Eng Windows 2000, 2003, XP) ..\Delade dokument\VIP2006\lib (Sv Windows 2000, 2003, XP) ..\Public\Public Documents\VIP2006\lib (Eng Vista) ..\Delat\Delade dokument\VIP2006\lib (Sv Vista) Vid kompileringar måste denna katalog finnas med i lib-sökvägarna och FÖRE sökvägen till VIP2006-lib-katalogerna i Visual Plus installationskatalog. Rätt sökvägar läggs in vid installation. Du kan kontrollera och ev justera sökvägarna via menyn Tools|Options och där under - C++ Options | Paths and Directories | Search Path - Delphi Options | Library - Win32 | Library path - Delphi Options | Library - NET | Library path - I Delphi-applikationer lägger du till VIP.pas i någon av Delphi-applikationens uses-listor. - I C++Builder kan du också lägga till VIP.pas bland projektfilerna, alternativt inkludera VIP.cpp och då anropa VIP::Init() i exv början av WinMain-metoden. - I C#-projekt lägger du till VIP.cs i projektet och anropar VIP.Init() i början av Main-metoden. VIP.pas, VIP.cpp resp. VIP.cs används endast vid kompileringen och behöver inte och får inte distribueras eller nyttjas av andra än licensinnehavaren. Detta gäller såväl VIP i källkodsversion (VIP.pas, VIP.cpp, VIP.cs), som i kompilerad form (VIP.dcu, VIP.obj, VIP.dcuil). VIP-komponenten - nu föråldrad ============================== I Visual Plus 7 och tidigare versioner, måste varje Delphi-applikation som använde Visual Plus-komponenter också innehålla en VIP-komponent. Detta behövs inte i Visual Plus 2006 och om du uppgraderar en äldre applikation kan du därför ta bort VIP-komponenten och dess enhet/unit (VCPVIP) ur applikationens uses-listor. Du kan alternativt välja att behålla VIP-komponenten (t ex om du bara vill testa Visual Plus 2006), men får då en varning vid kompileringen som säger att enheten VCPVIP är "deprecated". Du kan bortse från varningen. För att markera att VIP-komponenten är föråldrad, är dess komponentikon numera "gråad". För att licensmärka din applikation och slippa "trial"-skyltar och tidsbegränsningar, lägger du istället till enheten/unit VIP i någon av applikationens uses-listor. (I Visual Plus 8 användes istället enheten VPSerial för att låsa upp applikationer. Byt ut alla VPSerial mot VIP när du konverterar till BDS 2006.) Programexempel ============== Programexemplen installeras i underkatalogen ..\Program Files\DATABITEN\VIP2006\vipdemos (eng Windows) resp ..\Program\DATABITEN\VIP2006\vipdemos (svensk Windows). och kopieras av VIP2006Reg-programmet (avslutar installationen) till katalogen ..\VIP2006\vipdemos i Windows gemensamma, delade dokumentkatalog: ..\Shared Documents\VIP2006\vipdemos (Eng Windows 2000, 2003, XP) ..\Delade Dokument\VIP2006\vipdemos (Sv Windows 2000, 2003, XP) ..\Public\Public Documents\VIP2006\vipdemos (Eng Vista) ..\Delat\Delade Dokument\VIP2006\vipdemos (Sv Vista) (Eftersom standardanvändare (user) normalt inte har skrivrättigheter i Program-katalogen skulle du få problem om du försöker kompilera programexempel där. Under Windows Vista med aktiverad User Account Control (UAC), får du även problem som administratör. Av detta skäl kopierar VIP2006Reg programexemplen till den gemensamma, delade katalogen) Avinstallera Visual Plus 2006 Toolbox ===================================== Om du vill avinstallera Visual Plus, stegar du dig "baklänges" jämfört med installationen. - Stäng ner din utvecklingsmiljö. - Avregistrera Visual Plus-komponenterna från Delphi,BDS etc. och avregistrera Visual Plus-assemblies ur GAC. Detta görs enklast med programmet VIP2006UnReg.exe i Visual Plus 2006 rotkatalog, vanligen C:\Program\DATABITEN\VIP2006 eller C:\Program Files\DATABITEN\VIP2006 Kör VIP2006UnReg från samma användarkonto(n) som vid installationen. OBS! För komplett avinstallation under Vista måste du köra med utökade adminstratörsrättigheter. Högerklicka på VIP2006UnReg och välj "Run as Administrator/Kör som Administratör". - Öppna Windows kontrollpanel och välj"Lägg till/ta bort program", - Leta reda på "Visual Plus 2006 Toolbox" i listan med installerade program och klicka på knappen [Lägg till/ta bort]. Acceptera sedan standardvalen i dialogrutorna. Filkataloger ============ Observera att det interna formatet på kompilerade bpi-,dcu- dcp- och bpl-filer, skiljer sig åt mellan varje version av BDS, Delphi och C++Builder (1,2,3,4, 5, 6, 7, 2005, 2006, 2007). Detsamma gäller dcuil och dcpil-filer i Delphi 8, Delphi 2005, BDS2006 och RAD Studio 2007. Visual Plus 2006 dcu-, dcp- och designtime bpl-filer för VCL Win32 installeras vanligen i katalogen ..\VIP2006\lib\win32, medan runtime BPL-filer installeras i ..\VIP2006\rtl\win32 samt i Windows System32-katalog. Installationsprogrammet installerar filerna enligt följande filkatalogsstruktur: (.. står för diskenhet + ev underkatalog, tex C:\Program\DATABITEN) ..\VIP2006 Rotkatalog för Visual Plus 2006. Innehåller denna fil samt VIP2006License.htm, VIP2006License.rtf Licensvillkor för Visual Plus 2006 Toolbox VIP2006Trial.html, VIP2006Trial.rtf Licensvillkor för testversionen (Visual Plus 2006 Trial). VIP2006Reg.exe Ett program som används för att registrera Visual Plus 2006-komponenterna i BDS 2006 (Delphi 2006, C++Builder 2006) och Turbo-versionerna, samt registrera Visual Plus-assemblies i .NET 1.1 Global Assembly Cache (GAC). Registerering sker per användare i Windows. Dessutom kopierar programmet alla programexempel från installationskatalogen till underkatalogen VIP2006\vipdemos i Windows gemensamma, delade dokumentkatalog (typ Shared Documents\VIP2006\vipdemos). OBS! För komplett registrering av alla nycklar (i "HKey Local Machine"), registrering i GAC och kopiering av alla programexempel, måste du köra VIP2006Reg som administratör och under Vista dessutom med fullständiga administratörsrättigheter om "User Account Control" (UAC) är aktiverad. Detta görs genom att högerklicka på programikonen och välja "Kör som administratör/Run as administrator". Om du däremot bara vill registrera komponenterna för ett annat användarkonto, ska du köra VIP2006Reg direkt under detta konto. VIP2006UnReg.exe Kommandofil för att avregistrera Visual Plus-kompoenenterna i BDS2006 och Turbo samt Visual Plus-assemblies i GAC. Kör som administratör om du vill avregistrera "local machine"registervärden och avregistrera assemblies ur GAC. Programexempel i i den gemensamma, delade katalogen ..VIP2006\vipdemos, raderas däremot inte av detta program. För att avinstallera Visual Plus 2006 måste du därefter köra avinstallationen från kontrollpanelens Lägg till/Ta bort program. OBS! Du måste köra VIP2006UnReg som administratör och under Vista med fullständiga administratörsrättigheter om "User Access Control" (UAC) är aktiverat. Högerklicka på programikonen och starta med "Kör som adminstratör/Run as administrator". VIP2006Serial.exe Detta program används för att skapa VIP.pas, Vip.cpp och VIP.cs-filer som innehåller din personliga Visual Plus-licensnyckel. Filerna placeras i VIP2006\lib i Windows gemensamma, delade dokumentkatalog. Kan också skapa testversioner (trial) av VIP.pas, VIP.cpp och VIP.cs om originalen skadats eller förkommit. OBS! Med Windows 2000 och XP måste du köra VIP2006Serial som administratör eller "power user". Detta är inte nödvändigt under Vista. VIPProt32.exe Delphi-program som används för att skyddsmärka Delphi och C++Builder VCL Win32-applikationer som använder VPVCheck-komponenten. Används inte med .NET-applikationer! OBS! Du måste eventuellt köra VIPProt32 som administratör och under Vista med fullständiga administratörsrättigheter om "User Access Control" (UAC) är aktiverat. Högerklicka på programikonen och starta med "Kör som adminstratör/Run as administrator". Visual Plus 2006 Toolbox för VCL Win32 -------------------------------------- ..\VIP2006\rtl\win32 vip101_100.bpl, vclvip101_100.bpl vclvipx101_100.bpl Runtime-paket med Visual Plus-komponenter för VCL Win32. Måste installeras hos användare (vanligen i Windows System/System32-katalog) om dina applikationer har kompilerats med runtime-paket. vclvipvcheck101_100.bpl, hjälppaket som behövs under utveckling av skyddade applikationer, men som man varken behöver eller får distribuera till andra användare ..\WinNT\System32 (Windows 2000/2003/XP/Vistas:s systemkatalog) samma .bpl-filer. ..\VIP2006\lib\win32 dclvclvip101_100.bpl Designtime-paket som används under utveckling ..\VIP2006\include Header-filer (.hpp) till C++Builder ..\VIP2006\vipdemos\delphi vcl win32 Innehåller ett antal underkataloger med VCL Win32-baserade program- exempel för BDS Delphi 2006. Projektgruppen "Delphi VCL Win32 VIP-demos.bdsgroup" innehåller samtliga projekt utom MultiDoc. Läs ev ReadMe.Txt-filer i katalogerna. ..\VIP2006\vipdemos\delphi rtl win32 Innehåller ett antal underkataloger med konsolbaserade exempel för Delphi 2006 som inte är beroende av VCL utan endast det gemensamma runtime-biblioteket. ..\VIP2006\vipdemos\delphi vcl win32\MultiDoc Kompilerad version och källkod till MultiDoc, vår flikade webbläsare som introducerade flikar många år före FireFox. Du kan fritt använda och modifiera denna kod under förutsättning att du har köpt Visual Plus 2006 Toolbox. MultiDoc är byggd med användning av TVPBrowser-komponenten i Visual Plus 2006 Toolbox. Denna är i sin tur beroende av Microsofts Internet Explorer 5, 5.5, 6 eller 7, som därför måste finnas installerad (Internet Explorer 3 fungerar inte - av säkerhetsskäl rekommenderas version 7). MultiDoc är kompilerad med engelska texter. Om Windows är konfigurerad för svenska, och språkmodulen MultiDoc.SVE finns installerad i MultiDoc- katalogen, byts engelska texterna automatiskt ut mot svenska dito. Översättningen är gjord med Delphis Translation Manager. ..\VIP2006\vipdemos\delphi vcl.win32\MultiDoc\SVE Svenska HTML-baserade hjälptexter till MultiDoc ..\VIP2006\vipdemos\delphi vcl.win32\MultiDoc\ENG Engelska HTML-baserade hjälptexter till MultiDoc För mer information - starta MultiDoc och öppna den inbyggda hjälpen. ..\VIP2006\vipdemos\cpp vcl win32 Innehåller ett antal underkataloger med VCL Win32-baserade program- exempel för BDS C++Builder. Projektgruppen "CPP VCL Win32 VIP-demos.bdsgroup" innehåller samtliga projekt. Läs ev README.Txt-filer i katalogerna. Här är ett tips innan du kompilerar och provkör exempelprogrammen: Kontrollera under "Tools|Debugger Options|Borland Debuggers|Language Exceptions" att "Notify on language exceptions" INTE är förkryssad. Ändra i så fall. Visual Plus 2006 Toolbox för .NET --------------------------------- ..\VIP2006\rtl\net11 Databiten.Vip100_net11.dll, Databiten.Vclvip100_net11.dll, Runtime-paket/assemblies med Visual Plus-komponenter till BDS 2006. Måste installeras hos användare om dina applikationer har kompilerats med runtime-paket. ..\VIP2006\lib\net11 Databiten.VclVip100_net11.Design.dll Designtime-paket som installeras i utvecklingsmiljöm. .dcuil,.dcpil Kompilerade Visual Plus-enheter (dcuil) och paket (dcpil) som behövs under utveckling. ..\VIP2006\vipdemos\delphi vcl.net Innehåller ett antal underkataloger med VCL .NET-baserade program- exempel för BDS Delphi 2006. Läs ev ReadMe.Txt-filer i katalogerna. ..\VIP2006\vipdemos\delphi clr.net Innehåller ett antal underkataloger med konsolbaserade exempel för BDS Delphi 2006/Turbo Delphi .NET som inte är beroende av VCL .NET utan endast det gemensamma CLR runtime-biblioteket i .NET ..\VIP2006\vipdemos\csharp.net Innehåller ett antal underkataloger med konsolbaserade exempel för BDS 2006 C# som använder sig av Databiten.Vip.dll assembly Utskrift av Visual Plus-dokumentation --------------------------------- VIP-dokumentationen är formaterad för A5-format vilket gör att du får ordentligt tilltagna marginaler när du skriver ut den på A4-papper. Om du vill kan du välja att expandera sidorna till fulla A4 under printerinställningar före utskriften. Ett annat alernativ, som en del skrivare erbjuder, är att skriva ut två A5-sidor på varje A4-papper. Nyheter i ver 2006/10.1.2 ========================= - Installationen har inte längre stöd för Delphi 2007, C++Builder 2007 eller RAD Studio 2007, eftersom a) RAD Studio 2007, Delphi 2007 med Update 3 och C++Builder 2007 med Update 3 inte längre än paket-kompatibla med BDS 2006. b) Visual Plus 2007 Toolbox är klar och har komplett stöd för RAD Studio 2007, inkl .NET 2.0 och VCL .NET 2.0. Nyheter i ver 2006/10.1.1 ========================= + Stöd för C++Builder 2007 (t om Update 2) De problem med användning av run-timepaket i Delphi 2007 verkar vara borta med Delphi 2007 Update 1, så ett klokt råd är att installera denna uppdatering. Nyheter i ver 2006/10.1 ======================= + Stöd för Delphi 2007 (t om Update 2) + Stöd för installation under Windows Vista. + VPBrowser fungerar under Vista. + nya uppdaterade paketfiler (*.bpl) med versionsnummer "101", t ex vip101_100.bpl ersätter vip100_100.bpl (sista "_100" anger interna versionsnumret för BDS2006/Delphi 2007:s dcu-format). + Uppdaterat registreringsprogram VIP2006Reg.exe med stöd för registrering av VIP2006 i såväl BDS 2006 som RAD Studio/Delphi 2007, samt stöd för kopiering av programexempel till Windows gemensamma, delade dokumentkatalog (om man önskar kopiering av exempel ska VIP2006Reg startas med parametern "-c"). Definierar också nya environmentvariabler $(VIP) och $(VIPCommon). Nyheter i ver 2006/10.0 ======================= + Stöd för BDS 2006 Delphi och C++Builder Win32, VCL Win32. + Stöd för BDS 2006 Delphi och C# CLR .NET och VCL .NET. + Omarbetade exempelprogram. + Förenklad registrering av Visual Plus-komponenterna En stor nyhet i Visual Plus 2006 Toolbox är stödet för C++Builder 2006. Samtliga komponenter, med ett undantag TVPBrowser, kan användas i C++Builder-applikationer. TVPBrowser finns i komponentpaletten och kan placeras i ett C++ formulär, men det går inte att spara eller kompilera projektet, eftersom headerfiler och lib-filer saknas för TVPBrowser. Nyheter i ver 2005/9.00 ======================= + Stöd för Delphi 2005 Win32, VCL Win32, CLR .NET och VCL .NET. + Databiten.Vip har kompletterats med klasser som innehåller statiska medlemmar med samma namn som motsvarande globala konstanter, variabler och rutiner. Underlättar användning av Databiten.Vip från andra .NET-språk som C#. + VPCal/VPCalendar har uppdaterats med de kalenderförändringar som beslutades av riksdagen i december 2004, dvs att fr om 2005 är Nationaldagen 6 juni en helgdag, medan Annandag Pingst är en vardag. + Istället för VPSerial i Delphi 8, används VIP för att låsa upp Visual Plus-applikationer Visual Plus 2005/9.00 Toolbox är testad med Delphi 2005 Update 1. Nyheter i ver 8.00 ================== - VIP-komponenten behövs inte längre. Istället används en VPSerial-enhet. + Stöd för Delphi 8 .NET + VPCalendar - fler formateringsmöjligheter och friare fontval. + VPEnter - Flexiblare stöd för kontroller och klasser av kontroller, stöd för bakåstegning med [Skift][Enter]. + VPScale/VPGScale - stöd för fler bildskärmsformat, som "widescreen". + VPFFE/VPMFFE - Användning av standard NaN ("Not-a-number") vid fel. VIP 8 är testad med Delphi 8 .NET, Delphi 7.1 och Kylix 3 for Delphi. Nyheter i ver 7.01 ================== - Modifierat VPScale/VPGScale för att fungera bättre tillsammans med vissa kontroller, tex InfoPower från Woll2Woll. - Nya publicerade egenskaper hos VPCalendar: Anchors, Constraints, DragCursor (VCL), DragKind (VCL), DragMode, ParentCtl3D, ParentShowHint, PopupMenu, - Nya publicerade egenskaper hos VPBrowser: Anchors, Constraints, DragKind VIP 7.01 är testad med Delphi 7.00 och Kylix 3.00 for Delphi. Nyheter i ver 7.00 =================== Testad mot Delphi 7.00 och Kylix 3.00 for Delphi. Problem ======= Vi tar tacksamt emot alla tips om fel eller konstigheter samt förslag till förbättringar. Illustrationer ============== Bilder i VIP.xml och VIP.ib har hämtats från "Clipart"- biblioteken i Corel Draw 4.0 ((c) Corel Draw, One Mile Up och Totem) utom Stockolmssilhuetten som är hämtad från Micrografx Designer och Delfi-bilden som är privat.