Added jnacontrib.x11.api.X.Window.getSubwindows and fixed jnacontrib.x11.api.X.Window.getXXXProperty, returns null if the window property is not found.

Author: rm5248

CHANGES.md

@@ -11,17 +11,19 @@ Features
 * [#290](https://github.com/twall/jna/pull/290): Improved the stacktrace for the exceptions thrown by `com.sun.jna.Structure` - [@ebourg](https://github.com/ebourg).
 * [#332](https://github.com/twall/jna/pull/332): Added Win32 Monitor Configuration API in `com.sun.jna.platform.win32.Dxva2` - [@msteiger](https://github.com/msteiger).
 * Added Winspool monitor sample and updated Kernel32, WinBase, Winspool - [@wolftobias](https://github.com/wolftobias).
-* Added Some minor changes to MS Office samples Test and small changes to the MS Office samples Bug Fixes - [@wolftobias](https://github.com/wolftobias).
 * [#333](https://github.com/twall/jna/pull/333): Added `CoTaskMemAlloc`, `CoTaskMemRealloc` and `CoTaskMemFree` to `com.sun.jna.platform.win32.Ole32` - [@msteiger](https://github.com/msteiger).
 * [#334](https://github.com/twall/jna/pull/334): Added `com.sun.jna.platform.win32.Shell32.SHGetKnownFolderPath` and `KnownFolders` GUID constants - [@msteiger](https://github.com/msteiger).
 * [#338](https://github.com/twall/jna/pull/338): Added `com.sun.jna.platform.mac.XAttr` and `com.sun.jna.platform.mac.XAttrUtil` JNA wrapper for `<sys/xattr.h>` for Mac OS X - [@rednoah](https://github.com/rednoah).
 * [#339](https://github.com/twall/jna/pull/339): Added `GetWindowPlacement`, `SetWindowPlacement`, `AdjustWindowRect`, `AdjustWindowRectEx`, `ExitWindowsEx`, and `LockWorkstation` to `com.sun.jna.platform.win32.User32` - [@Timeroot](https://github.com/Timeroot).
 * [#286](https://github.com/twall/jna/pull/286): Added in com.sun.jna.platform.win32.Kernel32: CreateRemoteThread, WritePocessMemory and ReadProcessMemory - [@sstokic-tgm](https://github.com/sstokic-tgm).
+* [#350](https://github.com/twall/jna/pull/350): Added `jnacontrib.x11.api.X.Window.getSubwindows` - [@rm5248](https://github.com/rm5248).
+* Improved `contrib/msoffice` sample - [@wolftobias](https://github.com/wolftobias).
 
 Bug Fixes
 ---------
 * [#319](https://github.com/twall/jna/pull/319): Fix direct-mapping type-mapped pointer result types - [@marco2357](https://github.com/marco2357).
-* Added Variant and TlbImp Fixes - [@wolftobias](https://github.com/wolftobias).
+* [#350](https://github.com/twall/jna/pull/350): Fix `jnacontrib.x11.api.X.Window.getXXXProperty`, returns `null` if the window property is not found - [@rm5248](https://github.com/rm5248).
+* Fixed `com.sun.jna.platform.win32.Variant` and `TlbImp` - [@wolftobias](https://github.com/wolftobias).
 
 Release 4.1
 ===========
@@ -182,7 +184,7 @@ Bug Fixes
 * Fix runtime error in some instances where Structure.setFieldOrder is used (never return self when sharing AutoAllocated memory).
 * [#107](https://github.com/twall/jna/issues/107): `Structure.clear()` always calls `ensureAllocated()` to avoid NPE.
 * Ensure internal memory pointer is *always* allocated when calling `Structure.useMemory()`, even if layout is not yet determined.
- 
+
 Release 3.4.1
 =============
 
@@ -218,7 +220,7 @@ threads.
 * linux/arm 32-bit support (hardware provided by Alex Lam).
 * linux/ppc 32-bit support (hardware provided by Fritiof Hedman).
 * Preliminary linux/ia64, linux/ppc64 support (thanks to Laurent Guerby and the GCC compile farm).
-* Windows CE/Mobile support (w32ce-arm) (resources provided by andrea antonello and Hydrologis SRL).  
+* Windows CE/Mobile support (w32ce-arm) (resources provided by andrea antonello and Hydrologis SRL).
 * linux multi-arch support (kohsuke).
 * Added REG_QWORD registry type support
 * Add to `platform.unix.x11`: `XGrabKey`, `XUngrabKey`, `XSetErrorHandler`.
@@ -367,7 +369,7 @@ Bug Fixes
 
 * Fix WindowUtils exception on mouse over TrayIcon.
 * Fix bug toggling windows transparent/opaque (win32/OSX).
-* Avoid overwriting unchanged Pointer values in arrays (function calls with Pointer[] and Structure.read). 
+* Avoid overwriting unchanged Pointer values in arrays (function calls with Pointer[] and Structure.read).
 * Ensure Structure fields marked `final` are never written.
 * Fix bug preventing proper population Structure.ByReference fields on Structure read.
 * Ensure double buffering is disabled in components added to a transparent window.
@@ -387,7 +389,7 @@ Bug Fixes
 ---------
 
 * Fix crash with direct mapping if NULL struct* used (Issue 125).
-* Fix case where null-valued Structure fields would get non-null values on write. 
+* Fix case where null-valued Structure fields would get non-null values on write.
 * Synch callback Structure/Structure[] arguments on callback return.
 * Fix NPE when mapping an interface to the current process.
 * Automatically load proper C library version from current process on Linux (avoids crashing bug on Ubuntu with libc-i686 packages active).
@@ -417,7 +419,7 @@ Features
 
 * Handle String, Structure, Callback, Buffer, and primitive arrays in direct mappings.  Handle NativeMapped and TypeMapper, with optimized paths for IntegerType and PointerType.
 * Optionally throw errno/GetLastError as an exception.  This is preferred to (and more efficient than) calling Native.getLastError().
-* Unload/delete native library unpacked from jna.jar if Native class is garbage collected.  Only install shutdown hook if using the system class loader. 
+* Unload/delete native library unpacked from jna.jar if Native class is garbage collected.  Only install shutdown hook if using the system class loader.
 * Auto-write contiguous Structure arrays when first element is written.
 * Support NativeMapped[] as function arguments for interface-mapped libraries (Issue 90).
 * Enable function lookup within current process on Windows.
@@ -435,7 +437,7 @@ Release 3.1.0
 Features
 --------
 
-* Add raw JNI mapping of static Java methods.  Performance is about 10X that of traditional JNA interface mapping, although with less type conversion functionality. 
+* Add raw JNI mapping of static Java methods.  Performance is about 10X that of traditional JNA interface mapping, although with less type conversion functionality.
 * Add library option to allow passing/return of Java Objects.
 * Allow handling of uncaught callback exceptions (Issue 63).
 * Object oriented interface to X server (see contrib/x11)
@@ -449,7 +451,7 @@ Features
 Bug Fixes
 ---------
 
-* Run tests with libjsig.so, if available, which fixes some crashes when running tests on 64-bit platforms. 
+* Run tests with libjsig.so, if available, which fixes some crashes when running tests on 64-bit platforms.
 * Fix Issue 104.
 * Fix Issue 94 (Java 1.6 update 10 regression).
 * Fix Issue 51 (Java 1.6 update 10 regression).
@@ -510,7 +512,7 @@ Bug Fixes
 * Avoid overwriting unchanged Structure fields of type Pointer.
 * Avoid more content dragging on OSX or warn if it's too late.
 * Fix UnsatisfiedLinkError using transparent window on Win2K.
-* Fix memory leak with callbacks called from native threads with no Java context (johnwallace).  
+* Fix memory leak with callbacks called from native threads with no Java context (johnwallace).
 * Defer structure size calculation if type mapper not yet set, allowing type mapper to be set in derived constructors (colinwalters).
 * Ensure structure memory is allocated in Structure.read/writeField.
 
@@ -567,7 +569,7 @@ Features
 
 * Enable build/run using IBM's J9 VM (leonardo).
 * Make StdCallFunctionMapper attempt a leading underscore if the simpler mapping doesn't work.
-* Allow Structure.read to overwrite final fields (may not work on some 1.4 VMs). 
+* Allow Structure.read to overwrite final fields (may not work on some 1.4 VMs).
 
 Bug Fixes
 ---------
@@ -581,7 +583,7 @@ Bug Fixes
 * Fix callback allocation code on w32, solaris, freebsd, darwin (libffi was misconfigured).
 * Fix bug when NativeMapped fields are used in a Structure.ByValue instance.
 * Fix NPE calling Structure.read() before memory is initialized.
-* Fix NPE calling Structure.read/write with uninitialized NativeMapped fields. 
+* Fix NPE calling Structure.read/write with uninitialized NativeMapped fields.
 
 Release 3.0.2
 =============
@@ -628,7 +630,7 @@ Features
 * More supported platforms, via GCC's libffi (wmeissner)
 * Support struct by value as parameter and return value (duncan)
 * Support struct by reference within structures
-* Provide access to native peer for java.awt.Component 
+* Provide access to native peer for java.awt.Component
 * Provide access to native peer on OS X.
 * Support MINGW32 builds (fullung)
 * Allow per-field Structure read/write by field name
@@ -643,7 +645,7 @@ Features
 * Support lookup of OSX framework libraries by name
 * Explicit access to shared library global data
 * Invocation interception to facilitate translation of C preprocessor macros and inline functions
-* Provide utility to determine Web Start native library cache location; auto-include this path if jnidispatch is included as a &lt;nativelib&gt; (robertengels) 
+* Provide utility to determine Web Start native library cache location; auto-include this path if jnidispatch is included as a &lt;nativelib&gt; (robertengels)
 * Provide access to aligned memory
 * Versioning information embedded in jna.jar and native library
 
@@ -676,7 +678,7 @@ Features
 * Optimized shaped windows (chris deckers & olivier chafik); instantiation time improved by about 2-3 orders of magnitude for large, mostly contiguous shapes
 * Provide type mapping in callback arguments/results
 * Provide access to ByteBuffer direct address as a Pointer
-* Provide customization of native string encoding with jna.encoding system property 
+* Provide customization of native string encoding with jna.encoding system property
 
 Bug Fixes
 ---------
@@ -702,7 +704,7 @@ Features
 * Automatic handling of w32 UNICODE/ASCII variants
 * Automatic mapping of decorated w32 stdcall function names
 * Customizable, automatic type conversion of arguments and results (wmeissner)
-* Support char*[] arguments as Java String[] 
+* Support char*[] arguments as Java String[]
 * Structure supports Callback members (wmeissner)
 * getByteBuffer from Pointer/Memory (wmeissner)
 * Allow GC of native libraries