Skip to content

Commit 4542a3b

Browse files
authored
Update README.md
1 parent 07e68a6 commit 4542a3b

File tree

1 file changed

+83
-7
lines changed

1 file changed

+83
-7
lines changed

README.md

Lines changed: 83 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# ShellControls
22
## Shell Browser and Shell Tree Controls
3-
## ucShellBrowse v12.0 R1 and ucShellTree v2.9.1
4-
### Updated 03 Feb 2023 / 27 Jan 2024
3+
## ucShellBrowse v12.1 R1 and ucShellTree v2.9.2 **BETA**
4+
### Updated 18 Apr 2024
55

66
This repository contains a twinBASIC x86/x64 compatible port of my shell controls, ucShellBrowse and ucShellTree.
77

@@ -17,22 +17,98 @@ There's still some work to do in twinBASIC to complete user control support, but
1717

1818
### Using these controls in your project
1919

20-
**Requires [twinBASIC Beta 432](https://github.com/twinbasic/twinbasic/releases) or newer**
20+
**Requires [twinBASIC Beta 513](https://github.com/twinbasic/twinbasic/releases) or newer**
2121

2222
>[!IMPORTANT]
23-
>Now requires twinBASIC 432 or newer; it was broken in 424-431. You can still use it in 239-423 as well.
23+
>Now requires twinBASIC 513 or newer.
2424
2525
The demos are all set to open and run, to set these up in your project:
2626

27-
These projects use tbShellLib, the x64-compatible successor to oleexp.tlb written in twinBASIC. First add a reference to 'twinBASIC Shell Library' in Settings->COM Type Library / Active-X References by clicking TWINPACK PACKAGES and selecting it from the list, or manually downloading it from it's [repository](https://github.com/fafalone/tbShellLib).
27+
These projects use WinDevLib, the x64-compatible successor to oleexp.tlb written in twinBASIC. First add a reference to 'Windows Development Library for twinBASIC' in Settings->COM Type Library / Active-X References by clicking TWINPACK PACKAGES and selecting it from the list, or manually downloading it from it's [repository](https://github.com/fafalone/WinDevLib).
2828

29-
ShellControls.twinpack contains both controls as a tB Package and can be added via the same references location (Import the file, it's not on the package server yet). This reference must come before WinNativeForms; tbShellLib must still be added. Note that packages are read-only when added to a project. As of twinBASIC Beta 239, you can now experiment with building this as an Active-X DLL. You can then use the controls in VB6; however they're not working in VBA yet.
29+
----
30+
31+
Files:\
32+
ShellControlsTB.twinproj - Project file for building OCX controls.
33+
34+
ShellControlsPackage.twinpack - Contains both controls as a tB Package and can be added via the same references location (Import the file, it's not on the package server yet). This reference must come before WinNativeForms; tbShellLib must still be added. Note that packages are read-only when added to a project.
35+
36+
tbShellBrowseDemo.twinproj - Main ucShellBrowse demo project.
37+
38+
tbShellTree.twinproj - Main ucShellTree demo project.
39+
40+
FileDialogDemo.twinproj - Demo of combining ucShellBrowse and ucShellTree controls to make a highly customizable Open File dialog.
41+
42+
UCSBDemoVB.twinproj - Demonstrates use of ucShellBrowse configured as replacements for the built in VB/tB file controls (DriveListBox, DirListBox, and FileListBox).
3043

3144
As an alternative, to have them in an editable form, for ucShellTree, you need to import ucShellTree.twin and ucShellTree.tbcontrol. For ucShellBrowse, import ucShellBrowse.twin and ucShellBrowse.tbcontrol.
3245

3346
### Update
3447

35-
**IMPORTANT:** These controls now require [twinBASIC Beta 432](https://github.com/twinbasic/twinbasic/releases). The changes in/for this release allow building them as Active-X DLLs that can be used in VB6; however they're not working in VBA yet. They also require WinDevLib 7.0 or newer, if you're adding them to your own project.
48+
**IMPORTANT:** These controls now require [twinBASIC Beta 513](https://github.com/twinbasic/twinbasic/releases).
49+
50+
**Update highlights:**\
51+
-Thumbnail view in ucShellBrowse is now fixed
52+
-OCX builds now working in all hosts, tested in tB, VB6, Excel/Access 2021 x64.
53+
-New ucShellTree features
54+
55+
**ucShellBrowse v12.1.0 BETA Update**
56+
57+
```
58+
'New in v12.1 BETA (Released 18 April 2024)
59+
'
60+
'-Made LVS_EX_DOUBLEBUFFER an optional style (ListViewDoubleBuffer, default True)
61+
'
62+
'-Updated IWebBrowser[App] implementation to use Boolean for VARIANT_BOOL instead
63+
' of Integer (along with updating tbShellLib version which made this change).
64+
'
65+
'-Pointer math operations are now large-address safe, allowing safe use in apps
66+
' or as an OCX with LARGEADDRESSAWARE enabled.
67+
'
68+
'-Errors loading a single file are no longer fatal to the entire folder; also
69+
' generally improved error handling in load folder routines.
70+
'
71+
'-(Bug fix) Thumbnail view broken in all modes except 32bit compiled.
72+
```
73+
74+
**ucShellTree v2.9.2 BETA Update**
75+
76+
```
77+
'v2.9.2
78+
'
79+
'Special thanks to VBForums user Mith for his incredible work helping with new features
80+
'and bug fixes! Credit goes to him for most of the changes in 2.9.2 alpha and final.
81+
'
82+
'-Added ShowOnlyFileCheckboxes option: When Checkboxes = True and ShowFiles = True, will
83+
' show checkboxes only for files.
84+
'
85+
'-Try to load cached icons first
86+
'
87+
'-Minor sizing adjustment to eliminate 4px border.
88+
'
89+
'-(Bug fix) Default share/shortcut overlays not showing.
90+
'
91+
'-(Bug fix) New icon methods didn't properly support running without ComCtl6.
92+
'
93+
'-(Bug fix) Always Show extensions wasn't working.
94+
'
95+
'-(Bug fix) Disabling of Wow64 redirection wasn't reverted on terminate.
96+
'
97+
'-(Bug fix) If DPI awareness was on, IconSize would continuously grow.
98+
'
99+
'v2.9.2 (ALPHA, 29 Jan 2024)
100+
'-New FileExtensions property to choose between following Explorer's setting for hiding
101+
' known extensions, over forcing them to always show.
102+
'
103+
'-Added property CheckedPathCount.
104+
'
105+
'-Added UserOption mNeverExpandZip, to prevent expansion of .zip when ShowFiles = True.
106+
'
107+
'-(Bug fix) Border property not restored correctly due to re-reading it with the wrong
108+
' name from the property bag.
109+
'
110+
'-(Bug fix) Opening to a custom root would add the root as a child of itself.
111+
```
36112

37113
**ucShellTree v2.9.1 Update**
38114
```

0 commit comments

Comments
 (0)