Editing getDialogHandle - FilterMeisterWiki

When saving, enter the following:

   ##      ###    ZZZZ ZZZ   #####   ___   
  #  #    ## ##    ZZ   Z   ##   ## (  _`\ 
 #    #  ##   ##   ZZ   Z   ##      | ( (_)
 #    #  ##   ##   ZZ   Z    #####  | |  _ 
 #  # #  ##   ##   ZZ   Z        ## | (_( )
  #  #    ## ##    ZZ   Z   ##   ## (____/'
   ## #    ###      ZZZZ     #####

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: