summaryrefslogtreecommitdiffstats
path: root/macosx/README
diff options
context:
space:
mode:
authorKevin Walzer <kw@codebykevin.com>2017-11-28 02:57:45 (GMT)
committerKevin Walzer <kw@codebykevin.com>2017-11-28 02:57:45 (GMT)
commit29dab7c972526c49ff9bb2e6b756ccd536678fe9 (patch)
treeab4d12e4e530dfca6fbf751a267c8b60c724f379 /macosx/README
parente9a4d77a4ad230e3de06e853df233163bc10944b (diff)
parent28d8a9e9de096ffab451d6171343bc251ca60095 (diff)
downloadtk-29dab7c972526c49ff9bb2e6b756ccd536678fe9.zip
tk-29dab7c972526c49ff9bb2e6b756ccd536678fe9.tar.gz
tk-29dab7c972526c49ff9bb2e6b756ccd536678fe9.tar.bz2
Merge in remove_mac_decorations branch
Diffstat (limited to 'macosx/README')
-rw-r--r--macosx/README33
1 files changed, 2 insertions, 31 deletions
diff --git a/macosx/README b/macosx/README
index 2822968..bcd5dce 100644
--- a/macosx/README
+++ b/macosx/README
@@ -178,43 +178,14 @@ Window attribute names:
verticalZoom, closeBox, collapseBox, toolbarButton, sideTitlebar,
noTitleBar, unifiedTitleAndToolbar, metal, hud, noShadow, doesNotCycle,
noActivates, hideOnSuspend, inWindowMenu, ignoreClicks, doesNotHide,
- canJoinAllSpaces, moveToActiveSpace, nonActivating, black, dark, light,
- gray, red, green, blue, cyan, yellow, magenta, orange, purple,
- brown, clear, opacity
+ canJoinAllSpaces, moveToActiveSpace, nonActivating
Note that not all attributes are valid for all window classes.
Support for the 3 argument form was added with the Cocoa-based Tk 8.5.7, at the
same time support for some legacy Carbon-specific classes and attributes was
removed (they are still accepted by the command but no longer have any effect).
-The color window attributes (black, dark, red, etc.) and the "opacity" allow one to set the background and opacity of a textured ("metal") window. This allows a Tk window to implement a window without the dividing line between the titlebar and the rest of the window, or the "unified toolbar" effect, which is increasingly standard in Mac applications. An example:
-
-toplevel .f
-tk::unsupported::MacWindowStyle style .f document {metal light opaque closeBox collapseBox resizable standardDocument }
-
-pack [label .f.f -bg #ababab -text "This is a textured window\nwith opacity and a gray background\nsimilar to other Mac applications"] -fill both -expand yes
-
-The color attributes correspond to system-defined NSColor constants (e.g., red is [NSColor redColor]. The "light" and "dark" attributes correspond to lightGrayColor and darkGrayColor, respectively (because of the way the attributes are parsed, using "lightgray" and "darkgray" would cause a conflict with the core "gray" attribute).
-
-Below are the corresponding hex and/or Tk-defined colors that can be used from Tk widgets to match the NSColor-based attributes:
-
-black #000000
-dark #545454
-light #ababab
-white #ffffff
-gray #7f7f7f
-red #ff0000
-green #00ff00
-blue #0000ff
-cyan #00ffff
-yellow #ffff00
-magenta #ff00ff
-orange #ff8000
-purple #800080
-brown #996633
-clear systemTransparent
-
-- If you want to use Remote Debugging with Xcode, you need to set the
+If you want to use Remote Debugging with Xcode, you need to set the
environment variable XCNOSTDIN to 1 in the Executable editor for Wish. That will
cause us to force closing stdin & stdout. Otherwise, given how Xcode launches
Wish remotely, they will be left open and then Wish & gdb will fight for stdin.