winenablewin -- toggle the enable state of window (calls a mex-function)

Search Tips

Send Page To a Friend

[M-Utilities index]

[M-Utilities overview]

[M-Pack help desk]

M-Utilities: MATLAB function reference

winenablewin

Version 1.0

Requires MATLAB 6.0 (R12) or later

Software license agreement

Enable/disable any window(s) (PC-Windows only). A disabled window does not respond to any user input (e.g. via keyboard or mouse). Compatible with the MATLAB Compiler.

File format:	m-file
Editable source code:	yes
Utilises non-editable functions:	yes (mex dll, Windows API dll's)
Platform:	PC/Windows
Required MATLAB Toolboxes:	none (except core MATLAB)
Demo version limitations:	p-code only (cannot be compiled with the MATLAB Compiler)

Syntax:

	winenablewin(Window);
	winenablewin(Window,Enable);
	winenablewin(Window,Enable,Options);

Arguments:

Input:

Window

if numeric, the MATLAB figure handle of the MATLAB figure window to be affected. If non-scalar, all entries which are valid MATLAB figure handles will be affected.

otherwise must be a string containing the full or partial name of the window (MATLAB or non-MATLAB Window) to be affected.

Enable

[optional] numerical flag if equal to 1 [default] or empty, enable window(s); if equal to 0 disable window(s).

Options

[Optional] argument only relevant when the Window argument is a title (sub)-string rather than a MATLAB handle. Must be structure containing (some of) the fields listed below. Note: if the argument is omitted or if a given field is omitted, the respective [default] values are used.

Options.IsFullName	flag which, when set equal to 1, designates that Window contains the full name appearing in the titlebar of the window. Conversely, if the flag is set to 0 [default] this designates that Window contains only a portion of the full name string, thereby indicating that a search must be conducted (on all open windows) to determine the full name containing the partial string. Note: this is particularly useful when the window under question corresponds to a console application whose full name contains a path which depends on the location of the executable (and can therefore vary arbitrarily from installation to installation).

Options.CaseSensitive	flag which designates whether the search based on Window should be case-sensitive (flag value of 1, [default]) or case-insensitive (flag value of 0).

Options.AllWindows	flag which designates whether the search based on Window should return all windows which qualify (flag value of 1, [default]) or only the first qualifying window (flag value of 0)

Remarks:

This function utilizes a mex function (Windows DLL) called mexenablewin.dll which is a wrapper function around the Win32 API function EnableWindow. The accompanying mexenablewin.m contains only the pragma %#mex which indicates to the MATLAB Compiler to expect a mex file rather than an m-file at compile-time.

see also

top

Create a demo figure:
	h=figure(1);

Disable the window (using the MATLAB figure handle):
	winenablewin(h,0);
Re-enable the window (using the MATLAB figure handle)
	winenablewin(h);

Create two demo figures:
	h(1)=figure(1); h(2)=figure(2);
Disable both windows (using their MATLAB figure handles)
	winenablewin(h,0);
Re-enable both figures (based on their partial title strings, both containing the substring 'Fig')
	winenablewin('Fig');
Set the flag to manipulate only the first window found
	Options.AllWindows=0;
Only one of the figures will be disabled (i.e. the first found with 'Fig' in its name).
	winenablewin('Fig',0,Options);
Re-enable both figures (based on their partial title strings, both containing the substring 'Fig')
	winenablewin('Fig');
Set the flag to enable case-sensitive search of the name strings
	Options.CaseSensitive=1;
No action will be taken since the uppercase 'FIG' substring does not appear in either of the figure namestrings
	winenablewin('FIG',0,Options);
Disable only figure(1) (based on its unique title string)
	winenablewin('Figure No. 1',0);
Re-enable both figures (based on their partial title strings, both containing the substring 'Fig')
	winenablewin('Fig');
Set the flag to specify that full name expected (rather than partial)
	Options.IsFullName=1;
No action taken since 'No. 1' is not the full name
	winenablewin('No. 1',0,Options);
Disable figure(1) (based on its full title string)
	winenablewin('Figure No. 1',0,Options);

For an example on how to manipulate external (non-MATLAB) windows:

Open the default web browser at the Sounds Logical support area (requires internet access). The title of the browser window will contain the partial string 'Sounds Logical: M-Packs: Support'
	slmhelp -web;
Disable the browser window (using the non-MATLAB-window title partial string)
	winenablewin('Sounds Logical: M-Packs: Support',0);
Re-enable the browser window (using the non-MATLAB-window title partial string)
	winenablewin('Sounds Logical: M-Packs: Support',1);

Send Page To a Friend

home - news - products - store - support - site map - company info

legal notice - privacy statement