Editing getDialogHandle - FilterMeisterWiki

When saving, enter the following:

          _            _               ####   
         ( \          / \             ##  ##  
 ##  ##  | (         / _ \   ######  ##       
 ##  ##  | |        / ___ \  ##      ##  ###  
 ##  ##  | |       /_/   \_\ ####    ##   ##  
 ######  | |                 ##       ##  ##  
 ######  | (____/\           ##        ####   
 ##  ##  (_______/           ##

Visit Preferences to set your user name

= getDialogHandle =

== Syntax ==
:{{int* getDialogHandle()}}

== Returns ==
:A handle to the main dialog window.

== Description ==
:Gets the window handle of the filter dialog window.

== Example ==
<code>
// This code loads the user32.dll
// DLL included with Windows and
// uses it to hide and show the
// main filter window.
  
int* lib_user32;
int* functionPointer;
int* dialogHandle;
int returnval;

// Load the DLL library
lib_user32 = loadLib("user32");
if (lib_user32) {

// Get the function in the DLL
  functionPointer = getLibFn(lib_user32, "ShowWindow");
  if (functionPointer) {

// Get the handle of the dialog
    dialogHandle = getDialogHandle();

// Call the function to hide the dialog window
    msgBox(MB_OK, "Hiding...", "About to hide main dialog window");
    returnval = callLib(functionPointer, dialogHandle, SW_HIDE);

// Call the function to show the dialog window
    msgBox(MB_OK, "Showing...", "About to show dialog window again");
    returnval = callLib(functionPointer, dialogHandle, SW_SHOW);

}
  else msgBox(MB_OK, "Error", "Function wasn't loaded");

// Free the library DLL
  freeLib(lib_user32);

}
else msgBox(MB_OK, "Error", "DLL was not loaded");
</code>

== See Also ==
:((getCtlHandle))

== Comments ==
:Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.

Summary of change:
Add document to category: