TWOLToolBar - WOLGUI
Descendente de TWOLVisualControl. É a representação, em objeto WOL,
de uma barra de ferramentas básica da GUI em uso. Arquivo fonte: WOLGUI25.PP.
Propriedades da TWOLToolBar
| Propriedade |
Descrição |
| ButtonCount |
Propriedade que retorna o número de botões existentes na barra. |
| WinAlign |
Propriedade que indica o alinhamento da barra de ferramentas. É do tipo TWOLWinAlign. |
| AutoSize |
Propriedade que indica se a barra se ajusta ao tamanho dos botões ou não. |
| IconSize |
Propriedade que indica o tamanho dos ícones dos botões. Esses tamanhos são predeterminados. É do tipo
TWOLToolBarIconSize. |
| ButtonHeight |
Propriedade que informa a altura dos botões usados na barra de ferramentas. |
| ButtonWidth |
Propriedade que informa a largura dos botões usados na barra de ferramentas. |
| Flat |
Propriedade que informa se a barra é plana ou de alto-relevo. |
| Indent |
Propriedade que informa a distância entre um botão e outro. |
| List |
Propriedade que informa que os botões se ajustam como uma lista na barra. |
| RowCount |
Propriedade que informa a quantidade de linhas da barra de ferramentas. |
| ShowCaptions |
Propriedade que informa se os títulos dos botões devem ser mostrados ou não. |
| Wrapable |
Propriedade que informa que a barra de ferramentas é deslizável. |
| Buttons |
Propriedade que carrega os botões da barra de ferramentas. É do tipo TWOLToolButtons. |
Métodos e Eventos Públicos
| — procedure SaveToolBar; |
| procedimento usado para salvar os atributos da barra de ferramentas. Apenas no MS-Windows. |
| — procedure RestoreToolBar; |
| procedimento usado para restaurar os atributos salvos da barra de ferramentas. Apenas no MS-Windows. |
| — procedure Customize; |
| procedimento usado para mostrar uma caixa de diálogo para que se possar personalizar a barra de ferramentas. Apenas no MS-Windows. |
| — procedure AddButton(Btn:TWOLToolButton); |
| procedimento usado para adicionar um botão na barra de ferramentas. |
| — procedure InsButton(Btn:TWOLToolButton); |
| procedimento usado para inserir um botão na barra de ferramentas. A posição do botão é indicada pela propriedade index. |
| — procedure DelButton(Btn:Integer); |
| procedimento usado para apagar um botão de índice Btn da barra de ferramenta. |
TWOLToolButtons — TWOLToolBar
TWOLToolButtons é uma classe especial que não deve ser criado para uso com outros objetos. A barra de ferramentas
carrega uma propriedade com essa classe de objetos, a qual aponta para o conjunto de botões que a povoam.
Propriedades da TWOLToolButtons
| Propriedade |
Descrição |
| Button[Index:Integer] |
Propriedade que aponta para o botão de índice informado. É do tipo TWOLToolButton. |
| Count |
Propriedade que informa a quantidade de botões na lista. |
Métodos e Eventos Públicos
| — constructor Create(aOwner:TWOLToolBar); |
| Procedimento que cria um objeto pertinente a barra de ferramentas indicada. |
| — destructor Destroy; override; |
| Procedimento que destrói o objeto. |
| — procedure Add(aButton:TWOLToolButton); |
| Procedimento usado para adicionar um botão na lista. |
| — procedure Insert(aButton:TWOLToolButton); |
| Procedimento usado para inserir um botão na lista. |
| — procedure Delete(aIndex:Integer); |
| Procedimento usado para apagar um botão com índice da lista. |
| — procedure Clear; |
| Procedimento usado para limpar a lista de botões. |
| — procedure Assign(Value:TWOLToolButtons); |
| Procedimento usado para substituir a lista de botões atuais pela do objeto passado em Value. |
| — procedure BuildButtons; |
| Procedimento usado para refazer os botões na barra de ferramentas. |
TWOLToolButton — TWOLToolBar
Classe de objetos que representam um item da barra de ferramentas. Esses objetos são geridos pela classe TWOLToolButtons, que
os carrega coletivamente.
Propriedades do TWOLToolButton
| Propriedade |
Descrição |
| Handle |
Propriedade que retorna o handle do botão. É do tipo TWOLHandle. |
| Name |
Propriedade que contém o nome dado ao botão. |
| AllowAllUp |
Propriedade que indica que todos os botões podem estar com estado não pressionado. |
| Down |
Propriedade que indica se o botão está pressionado ou não. |
| Grouped |
Propriedade que indica que o botão faz parte de um grupo. |
| ImgIcon |
Propriedade que indica o ícone do botão. Esse ícone é predefinido. É do tipo TWOLToolButtonIcon. |
| Indeterminate |
Propriedade que indica que o botão pode ficar num estado indefinido. |
| Style |
Propriedade que informa o estilo do botão. É do tipo TWOLToolButtonStyle. |
| State |
Propriedade que informa o estado do botão. É do tipo TWOLToolButtonState. |
| Wrap |
Propriedade que informa que o botão pode rolar dentro da barra de ferramentas. |
| Hint |
Propriedade que carrega a dica que é apresentada quando o mouse pára sobre o botão. |
| Caption |
Propriedade que carrega o título do botão. |
| Visible |
Propriedade que define se o botão é visível ou não. |
| Index |
Propriedade que informa o índice do botão (baseado em zero). |
| Enabled |
Propriedade que indica se o botão está habilitado ou não. |
Métodos e Eventos Públicos
| — constructor Create; |
| Método usado para criar o objeto. |
| — destructor Destroy; override; |
| Método usado para destruir o objeto. |
| — procedure Assign(aButton:TWOLToolButton); |
| Procedimento usado para copiar as propriedades do botão passado como argumento. |
| — OnClick:TWOLEvent |
| Evento disparado quando o botão é clicado. |
Entrada de Botões no WOL Designer
No WOL Designer há uma janela de entrada para os botões da barra de ferramentas, conforme figura abaixo. Os botões são baseados na
barra de ferramentas padrão do MS-Windows. Somente existe um conjunto de botões padrão nessa interface, mas, usando-se o handle
do botão, pode-se alterar seu ícones e outros aspectos.
Os botões da barra de ferramentas são automaticamente refletidos no formulário de trabalho, porém, os eventos ainda tem de ser
escritos no código fonte manualmente.
