Module Tix :: Class tixCommand
[hide private]
[frames] | no frames]

_ClassType tixCommand

Known Subclasses:

The tix commands provide access to miscellaneous elements of Tix's internal state and the Tix application context. Most of the information manipulated by these commands pertains to the application as a whole, or to a screen or display, rather than to a particular window.

This is a mixin class, assumed to be mixed to Tkinter.Tk that supports the self.tk.call method.

Instance Methods [hide private]
 
tix_addbitmapdir(self, directory)
Tix maintains a list of directories under which the tix_getimage and tix_getbitmap commands will search for image files.
 
tix_cget(self, option)
Returns the current value of the configuration option given by option.
 
tix_configure(self, cnf=None, **kw)
Query or modify the configuration options of the Tix application context.
 
tix_filedialog(self, dlgclass=None)
Returns the file selection dialog that may be shared among different calls from this application.
 
tix_getbitmap(self, name)
Locates a bitmap file of the name name.xpm or name in one of the bitmap directories (see the tix_addbitmapdir command above).
 
tix_getimage(self, name)
Locates an image file of the name name.xpm, name.xbm or name.ppm in one of the bitmap directories (see the addbitmapdir command above).
 
tix_option_get(self, name)
Gets the options manitained by the Tix scheme mechanism.
 
tix_resetoptions(self, newScheme, newFontSet, newScmPrio=None)
Resets the scheme and fontset of the Tix application to newScheme and newFontSet, respectively.
Method Details [hide private]

tix_addbitmapdir(self, directory)

 

Tix maintains a list of directories under which the tix_getimage and tix_getbitmap commands will search for image files. The standard bitmap directory is $TIX_LIBRARY/bitmaps. The addbitmapdir command adds directory into this list. By using this command, the image files of an applications can also be located using the tix_getimage or tix_getbitmap command.

tix_cget(self, option)

 

Returns the current value of the configuration option given by option. Option may be any of the options described in the CONFIGURATION OPTIONS section.

tix_configure(self, cnf=None, **kw)

 

Query or modify the configuration options of the Tix application context. If no option is specified, returns a dictionary all of the available options. If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given option(s) to have the given value(s); in this case the command returns an empty string. Option may be any of the configuration options.

tix_filedialog(self, dlgclass=None)

 

Returns the file selection dialog that may be shared among different calls from this application. This command will create a file selection dialog widget when it is called the first time. This dialog will be returned by all subsequent calls to tix_filedialog. An optional dlgclass parameter can be passed to specified what type of file selection dialog widget is desired. Possible options are tix FileSelectDialog or tixExFileSelectDialog.

tix_getbitmap(self, name)

 

Locates a bitmap file of the name name.xpm or name in one of the bitmap directories (see the tix_addbitmapdir command above). By using tix_getbitmap, you can avoid hard coding the pathnames of the bitmap files in your application. When successful, it returns the complete pathname of the bitmap file, prefixed with the character '@'. The returned value can be used to configure the -bitmap option of the TK and Tix widgets.

tix_getimage(self, name)

 

Locates an image file of the name name.xpm, name.xbm or name.ppm in one of the bitmap directories (see the addbitmapdir command above). If more than one file with the same name (but different extensions) exist, then the image type is chosen according to the depth of the X display: xbm images are chosen on monochrome displays and color images are chosen on color displays. By using tix_ getimage, you can advoid hard coding the pathnames of the image files in your application. When successful, this command returns the name of the newly created image, which can be used to configure the -image option of the Tk and Tix widgets.

tix_option_get(self, name)

 
Gets  the options  manitained  by  the  Tix
scheme mechanism. Available options include:

    active_bg       active_fg      bg
    bold_font       dark1_bg       dark1_fg
    dark2_bg        dark2_fg       disabled_fg
    fg              fixed_font     font
    inactive_bg     inactive_fg    input1_bg
    input2_bg       italic_font    light1_bg
    light1_fg       light2_bg      light2_fg
    menu_font       output1_bg     output2_bg
    select_bg       select_fg      selector
    

tix_resetoptions(self, newScheme, newFontSet, newScmPrio=None)

 

Resets the scheme and fontset of the Tix application to newScheme and newFontSet, respectively. This affects only those widgets created after this call. Therefore, it is best to call the resetoptions command before the creation of any widgets in a Tix application.

The optional parameter newScmPrio can be given to reset the priority level of the Tk options set by the Tix schemes.

Because of the way Tk handles the X option database, after Tix has been has imported and inited, it is not possible to reset the color schemes and font sets using the tix config command. Instead, the tix_resetoptions command must be used.