FindwxWindows — CMake 4.1.4 Documentation

# FindwxWindows

Deprecated since version 3.0: Replaced by `FindwxWidgets`.

Finds the wxWidgets (formerly known as wxWindows) installation and determines the locations of its include directories and libraries, as well as the name of the library.

wxWidgets 2.6.x is supported for monolithic builds, such as those compiled in the `wx/build/msw` directory using:

    nmake -f makefile.vc BUILD=debug SHARED=0 USE_OPENGL=1 MONOLITHIC=1

## Result Variables

This module defines the following variables:

`WXWINDOWS_FOUND`

  Boolean indicating whether the wxWidgets is found.

`WXWINDOWS_LIBRARIES`

  Libraries needed to link against to use wxWidgets. This includes paths to the wxWidgets libraries and any additional linker flags, typically derived from the output of `wx-config --libs` on Unix/Linux systems.

`CMAKE_WXWINDOWS_CXX_FLAGS`

  Compiler options needed to use wxWidgets (if any). On Linux, this corresponds to the output of `wx-config --cxxflags`.

`WXWINDOWS_INCLUDE_DIR`

  The directory containing the `wx/wx.h` and `wx/setup.h` header files.

`WXWINDOWS_LINK_DIRECTORIES`

  Link directories, useful for setting `rpath` on Unix-like platforms.

`WXWINDOWS_DEFINITIONS`

  Extra compile definitions needed to use wxWidgets (if any).

## Hints

This module accepts the following variables before calling the `find_package(wxWindows)`:

`WXWINDOWS_USE_GL`

  Set this variable to boolean true to require OpenGL support.

`HAVE_ISYSTEM`

  Set this variable to boolean true to replace `-I` compiler options with `-isystem` when the C++ compiler is GNU (`g++`).

## Deprecated Variables

These variables are provided for backward compatibility:

`CMAKE_WX_CAN_COMPILE`

  Deprecated since version 1.8: Replaced by the `WXWINDOWS_FOUND` variable with the same value.

`WXWINDOWS_LIBRARY`

  Deprecated since version 1.8: Replaced by the `WXWINDOWS_LIBRARIES` variable with the same value.

`CMAKE_WX_CXX_FLAGS`

  Deprecated since version 1.8: Replaced by the `CMAKE_WXWINDOWS_CXX_FLAGS` variable with the same value.

`WXWINDOWS_INCLUDE_PATH`

  Deprecated since version 1.8: Replaced by the `WXWINDOWS_INCLUDE_DIR` variable with the same value.

## Examples

### Example: Finding wxWidgets in earlier CMake versions

In earlier versions of CMake, wxWidgets (wxWindows) could be found using:

    find_package(wxWindows)

To request OpenGL support, the `WXWINDOWS_USE_GL` variable could be set before calling `find_package()`:

    set(WXWINDOWS_USE_GL ON)
    find_package(wxWindows)

Using wxWidgets (wxWindows) in CMake was commonly done by including the `Use_wxWindows` module, which would find wxWidgets and set the appropriate libraries, include directories, and compiler flags:

    include(Use_wxWindows)

### Example: Finding wxWidgets as of CMake 3.0

Starting with CMake 3.0, wxWidgets can be found using the `FindwxWidgets` module:

    find_package(wxWidgets)