From 84adefa331c4159d432d22840663c38f155cd4c1 Mon Sep 17 00:00:00 2001 From: Erlang/OTP Date: Fri, 20 Nov 2009 14:54:40 +0000 Subject: The R13B03 release. --- lib/gs/src/gstk_button.erl | 220 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 220 insertions(+) create mode 100644 lib/gs/src/gstk_button.erl (limited to 'lib/gs/src/gstk_button.erl') diff --git a/lib/gs/src/gstk_button.erl b/lib/gs/src/gstk_button.erl new file mode 100644 index 0000000000..0ef6f877b4 --- /dev/null +++ b/lib/gs/src/gstk_button.erl @@ -0,0 +1,220 @@ +%% +%% %CopyrightBegin% +%% +%% Copyright Ericsson AB 1996-2009. All Rights Reserved. +%% +%% The contents of this file are subject to the Erlang Public License, +%% Version 1.1, (the "License"); you may not use this file except in +%% compliance with the License. You should have received a copy of the +%% Erlang Public License along with this software. If not, it can be +%% retrieved online at http://www.erlang.org/. +%% +%% Software distributed under the License is distributed on an "AS IS" +%% basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See +%% the License for the specific language governing rights and limitations +%% under the License. +%% +%% %CopyrightEnd% +%% + +%% +%% ------------------------------------------------------------ +%% Basic Button Type +%% ------------------------------------------------------------ + +-module(gstk_button). + +%%------------------------------------------------------------------------------ +%% BUTTON OPTIONS +%% +%% Attributes: +%% activebg Color +%% activefg Color +%% align n,w,s,e,nw,se,ne,sw,center +%% anchor n,w,s,e,nw,se,ne,sw,center +%% bg Color +%% bw Int +%% data Data +%% disabledfg Color +%% fg Color +%% font Font +%% height Int +%% highlightbg Color +%% highlightbw Int +%% highlightfg Color +%% justify left|right|center +%% label {text, String} | {image, BitmapFile} +%% padx Int (Pixels) +%% pady Int (Pixels) +%% relief Relief [flat|raised|sunken|ridge|groove] +%% underline Int +%% width Int +%% wraplength Int +%% x Int +%% y Int +%% +%% Commands: +%% enable Bool +%% flash +%% invoke +%% setfocus Bool +%% +%% Events: +%% buttonpress [Bool | {Bool, Data}] +%% buttonrelease [Bool | {Bool, Data}] +%% click [Bool | {Bool, Data}] +%% configure [Bool | {Bool, Data}] +%% destroy [Bool | {Bool, Data}] +%% enter [Bool | {Bool, Data}] +%% focus [Bool | {Bool, Data}] +%% keypress [Bool | {Bool, Data}] +%% keyrelease [Bool | {Bool, Data}] +%% leave [Bool | {Bool, Data}] +%% motion [Bool | {Bool, Data}] +%% +%% Read Options: +%% children +%% id +%% parent +%% type +%% +%% Not Implemented: +%% cursor ?????? +%% font ?????? +%% + +-export([create/3,config/3,read/3,delete/2,event/5,option/5,read_option/5]). + +-include("gstk.hrl"). + +%%--------------------------------------------------------------------------- +%% MANDATORY INTERFACE FUNCTIONS +%%--------------------------------------------------------------------------- +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Function : create/3 +%% Purpose : Create a widget of the type defined in this module. +%% Return : [Gsid_of_new_widget | {bad_result, Reason}] +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +create(DB, GstkId, Opts) -> + TkW = gstk_generic:mk_tkw_child(DB,GstkId), + NGstkId=GstkId#gstkid{widget=TkW}, + PlacePreCmd = [";place ", TkW], + case gstk_generic:make_command(Opts,NGstkId,TkW,"",PlacePreCmd,DB) of + {error,Reason} -> {error,Reason}; + Cmd when is_list(Cmd) -> + gstk:exec(["button ", TkW," -rel raised -bo 2 ",Cmd]), + NGstkId + end. + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Function : config/3 +%% Purpose : Configure a widget of the type defined in this module. +%% Args : DB - The Database +%% Gstkid - The gstkid of the widget +%% Opts - A list of options for configuring the widget +%% +%% Return : [true | {bad_result, Reason}] +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +config(DB, Gstkid, Opts) -> + TkW = Gstkid#gstkid.widget, + SimplePreCmd = [TkW, " conf"], + gstk_generic:mk_cmd_and_exec(Opts,Gstkid,SimplePreCmd,DB). + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Function : read/3 +%% Purpose : Read one option from a widget +%% Args : DB - The Database +%% Gstkid - The gstkid of the widget +%% Opt - An option to read +%% +%% Return : [OptionValue | {bad_result, Reason}] +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +read(DB, Gstkid, Opt) -> + gstk_generic:read_option(DB, Gstkid, Opt). + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Function : delete/2 +%% Purpose : Delete widget from databas and return tkwidget to destroy +%% Args : DB - The Database +%% Gstkid - The gstkid of the widget +%% +%% Return : TkWidget to destroy +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +delete(DB, Gstkid) -> + gstk_db:delete_widget(DB, Gstkid), + Gstkid#gstkid.widget. + +event(DB, Gstkid, Etype, Edata, Args) -> + gstk_generic:event(DB, Gstkid, Etype, Edata, Args). + +%%------------------------------------------------------------------------------ +%% MANDATORY FUNCTIONS +%%------------------------------------------------------------------------------ +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Function : option/4 +%% Purpose : Take care of options +%% Args : Option - An option tuple +%% Gstkid - The gstkid of the widget +%% TkW - The tk-widget +%% DB - The Database +%% +%% Return : A tuple {OptionType, OptionCmd} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +option(Option, Gstkid, TkW, DB,_) -> + case Option of + {bitmap, Bitmap} -> {s, [" -bi @", Bitmap]}; + {disabledfg, Color} -> {s, [" -disabledf ", gstk:to_color(Color)]}; + {underline, Int} -> {s, [" -un ", gstk:to_ascii(Int)]}; + {wraplength, Int} -> {s, [" -wr ", gstk:to_ascii(Int)]}; + invoke -> {c, [TkW, " i;"]}; + flash -> {c, [TkW, " f;"]}; + {click, On} -> cbind(DB, Gstkid, click, On); + _ -> invalid_option + end. + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Function : read_option/4 +%% Purpose : Take care of a read option +%% Args : DB - The Database +%% Gstkid - The gstkid of the widget +%% Option - An option +%% +%% Return : The value of the option or invalid_option +%% [OptionValue | {bad_result, Reason}] +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +read_option(Option,Gstkid, TkW,DB,_) -> + case Option of + disabledfg -> tcl2erl:ret_color([TkW, " cg -disabledf"]); + underline -> tcl2erl:ret_int([TkW, " cg -un"]); + wraplength -> tcl2erl:ret_int([TkW, " cg -wr"]); + + click -> gstk_db:is_inserted(DB, Gstkid, click); + + _ -> {bad_result, {Gstkid#gstkid.objtype, invalid_option, Option}} + end. + +%%------------------------------------------------------------------------------ +%% PRIMITIVES +%%------------------------------------------------------------------------------ + +%% +%% Config bind +%% +cbind(DB, Gstkid, Etype, On) -> + TkW = Gstkid#gstkid.widget, + Cmd = case On of + {true, Edata} -> + Eref = gstk_db:insert_event(DB, Gstkid, Etype, Edata), + [" -command {erlsend ", Eref, " \\\"[", TkW, " cg -text]\\\"}"]; + true -> + Eref = gstk_db:insert_event(DB, Gstkid, Etype, ""), + [" -command {erlsend ", Eref, " \\\"[", TkW, " cg -text]\\\"}"]; + _Other -> + gstk_db:delete_event(DB, Gstkid, Etype), + " -command {}" + end, + {s, Cmd}. + +%% ----- Done ----- + -- cgit v1.2.3