From 3a68b18a3b76767d9a2f68ae13535bd80a4f9f11 Mon Sep 17 00:00:00 2001
From: lemort
Date: Tue, 22 Jan 2008 12:44:26 +0000
Subject: Ajout de la doc pour le nouvel attribut de l'item window
 (-windowtitle) ET mise a jour de la description generale pour indiquer que
 cela fonctionne avec les applications Windows

---
 doc/refman.tex | 35 ++++++++++++++++++++++++++---------
 1 file changed, 26 insertions(+), 9 deletions(-)

(limited to 'doc/refman.tex')

diff --git a/doc/refman.tex b/doc/refman.tex
index 07e7032..46ad0e2 100644
--- a/doc/refman.tex
+++ b/doc/refman.tex
@@ -285,6 +285,9 @@ This document is also referenced as CENA technical note NT03-532.
 
 \subsection{Differences between 3.3.X and 3.3 release}
 \begin{itemize}
+\item  Items ot type window have a new attribute -windowtitle to
+  retrieve and display any top-level window whose title matches the
+  value of windowtitle
 \item  Damage support can now be controlled by a new TkZinc option
   -usedamage 
 \item  TkZinc now supports MouseWheel events under Windows
@@ -4032,7 +4035,7 @@ value is {\tt true}.}
 \section{Window items}
 \object{window}
 
-  Items of type \ident{window} display an X11 window at a given position in the widget.
+  Items of type \ident{window} display a Tk window, an X11 window or a Win32 window at a given position in the widget.
 
   It is possible to use this item as a clip item for its group, the clip shape will be the
   window rectangle. It is also possible to use the rectangular shape of the window item in
@@ -4041,14 +4044,24 @@ value is {\tt true}.}
   command (i.e. if no connected item is specified).
 
   One of the most frequent use of this item is to embed any Tk widget into TkZinc,
-  including, of course, another TkZinc instance. Another less obvious use is to embed a
-  whole Tk application into TkZinc, here is how to do it: The embedding application should
-  create a frame with the \ident{-container} option set to true; Add a window item to the
-  relevant TkZinc widget with the \attributeref{window}{window} attribute set to the id of
-  the container frame; The embedded application should create its toplevel with the
-  \ident{-use} option set to the id of the container frame; Or, as an alternative, the
-  embedded \cident{wish} can be launched with the \ident{-use} option set to the container
-  frame id.
+  including, of course, another TkZinc instance. 
+
+  (Compatible with old version) Another less obvious use is to embed a whole Tk application into
+  TkZinc, here is how to do it: The embedding application should
+  create a frame with the \ident{-container} option set to true; Add a
+  window item to the relevant TkZinc widget with the
+  \attributeref{window}{window} attribute set to the id of the
+  container frame; The embedded application should create its toplevel
+  with the  \ident{-use} option set to the id of the container frame;
+  Or, as an alternative, the embedded \cident{wish} can be launched
+  with the \ident{-use} option set to the container frame id.
+
+  (With the \attributered{windowtitle}{windowtitle} attribute) It is possible to embed a whole
+  external application into TkZinc using the \ident{-windowtitle}
+  attribute. The \ident{-windowtitle} attribute must specify a string
+  pattern to match against the title of any running applications. The
+  external application will be embedded in TkZinc and released when
+  the window item is destroyed.
   
 Applicable attributes for \ident{window} items are:
 
@@ -4102,6 +4115,10 @@ units. The default value is {\tt 0}.}
 the item. This id can be obtained by the Tk command \ident{winfo id widgetname}. The
 default value is {\tt ""}.}
 
+\attribute{window}{windowtitle}{string}{Specifies a string pattern to
+  match against the title of any running application. It may contain
+  special characters from the set *?\\[].}
+
 
 %%
 %%
-- 
cgit v1.1

