Translate

Jump to: navigation, search
Settings

Information about the group Translation of the wiki page Development/Architecture/KDE3/Icon Loader.
Development/Architecture/KDE3/Icon LoaderCurrent message text
... Loader/Page display title/pt-brDevelopment/Architecture/KDE3/Icon Loader
...tecture/KDE3/Icon Loader/1/pt-br'''Carregando e instalando ícones no KDE'''
...tecture/KDE3/Icon Loader/2/pt-brOs ícones são um importante elemento de interface do usuário em qualquer ambiente de trabalho. Devido a diferentes preferências do usuário e de hardware de vídeo, um ícone pode vir em diferentes tamanhos e profundidades de exibição. Para que isso seja gerenciável, uma forma padrão de armazenamento e acesso a ícones foi desenvolvido.
...tecture/KDE3/Icon Loader/3/pt-br== Carregamento de ícones ==
...tecture/KDE3/Icon Loader/4/pt-br===  Acessando o iconloader  ===
...tecture/KDE3/Icon Loader/5/pt-brÍcones são carregados usando a classe [http://api.kde.org/3.5-api/kdelibs-apidocs/kdecore/html/classKIconLoader.html KIconLoader]. Todo appliation do KDE
tem um objeto iconloader global. Você pode acessar esse objeto com:
...tecture/KDE3/Icon Loader/6/pt-br<syntaxhighlight lang="cpp-qt">
#include <kglobal.h>
#include <kiconloader.h>
 
KIconLoader *loader = KGlobal::iconLoader();
</syntaxhighlight>
...tecture/KDE3/Icon Loader/7/pt-br===  Carregando ícones com loadIcon  ===
...tecture/KDE3/Icon Loader/8/pt-brO iconloader carrega ícones, faz o '''cache''' deles e aplica efeitos.
Para carregar um ícone, use o método [http://api.kde.org/3.5-api/kdelibs-apidocs/kdecore/html/classKIconLoader.html#a3 loadIcon()], que é definido assim:
...tecture/KDE3/Icon Loader/9/pt-br<syntaxhighlight lang="cpp-qt">
QPixmap loadIcon( QString name, int group, int size=0,
                 int state=KIcon::DefaultState, 
                 QString *path_store=0L, bool canReturnNull=false);
</syntaxhighlight>
...ecture/KDE3/Icon Loader/10/pt-brComo você vê, existem muitos parâmetros. Os dois primeiros são os mais importantes:
...ecture/KDE3/Icon Loader/11/pt-br# '''name''' - O nome do ícone a ser carregado. Você deve passar o nome do ícone aqui, sem extensão.
# '''group''' - O grupo do ícone. Isto é explicado abaixo.
...ecture/KDE3/Icon Loader/12/pt-br===  Grupos de ícone  ===
...ecture/KDE3/Icon Loader/13/pt-brA ideia de um ''grupo de ícone'' é um conceito importante no esquema de ícone do KDE.  
O grupo de ícone indica onde na tela o ícone vai ser usado.
Isso é relevante, pois o usuário pode vincular os tamanhos dos ícones e efeitos visuais do KDE para cada grupo. Ao passar o grupo de ícone para o carregador de ícone, você está na verdade dizendo-lhe que encarnação do ícone deve carregar. E, exigindo o argumento do grupo, o iconloader fornece os meios para ter um consistente e configurável exame de ícone sobre toda a área de trabalho do KDE.
...ecture/KDE3/Icon Loader/14/pt-brPor exemplo: o usuário pode configurar que ele deseja ícones de 32 pixels com 0.2
de dessaturação para as barras de ferramentas principais.
...ecture/KDE3/Icon Loader/15/pt-brOs grupos de ícones disponíveis são apresentados abaixo. Todos estão definidos na classe [http://api.kde.org/3.5-api/kdelibs-apidocs/kdecore/html/classKIcon.html KIcon], assim prefixe-os com ''KIcon::''.
...ecture/KDE3/Icon Loader/16/pt-br* '''Desktop''' - Ícones para uso na área de trabalho, no gerenciador de arquivos e locais similares.
* '''Toolbar''' - Ícone para as barras de ferramentas normais.
* '''MainToolbar''' - Ícones para a barra de ferramentas principal. Um aplicativo pode ter várias barras de ferramentas, das quais uma é sempre a principal. Isso normalmente tem ítens como "Salvar" e "Abrir" e contém ícones maiores que outras barras de ferramentas.
* '''Small''' - Vários ícones pequenos, como os de menus pop-up, exibição em lista e listas em árvore.
* '''User''' - Grupo especial para carregar ícones específicos de aplicativos. Isso é explicado na seção 3: Instalando ícones.
...ecture/KDE3/Icon Loader/17/pt-brAssim, para carregar o ícone "kfind" para usar no grupo ''Desktop'', você usaria:
...ecture/KDE3/Icon Loader/18/pt-br<syntaxhighlight lang="cpp-qt">
QPixmap icon;
icon = loader->loadIcon("kfind", KIcon::Desktop);
</syntaxhighlight>
...ecture/KDE3/Icon Loader/19/pt-br===  loadIcon continua  ===
...ecture/KDE3/Icon Loader/20/pt-brAgora vamos discutir os outros parâmetros de ''loadIcon''.
...ecture/KDE3/Icon Loader/21/pt-br# '''size''' - Substituir o tamanho configurado globalmente para o grupo de ícone especificado. Efeitos ligados ao grupo ainda são aplicados.
# '''state''' - O estado do ícone. O estado do ícone é ''KIcon::DefaultState'', ''KIcon::ActiveState'' ou ''KIcon::DisabledState''. O estado ícone denota em que estado o ícone está. Botões da barra de ferramentas, por exemplo, estão no estado "ativo'' se o ponteiro do mouse está sobre eles, no estado ''desativado'' quando eles não estão disponíveis, e ''padrão'' caso contrário. Cada estado do ícone pode ter diferentes efeitos atribuídos a ele para dar o feedback ao visual do usuário.
# '''path_store''' - Se você quer saber onde o ícone que você acabou de carregar está no sistema de arquivos, você pode passar um ponteiro para uma QString aqui e o caminho do ícone é armazenado lá.
# '''canReturnNull''' - Se o ícone requisitado não for encontrado, o resultado de ''loadIcon'' depende desse parâmetro. Se ''canReturnNull'' é ''true'', um pixmap nulo retornará, se não, o ícone "unknown" é retornado.
...ecture/KDE3/Icon Loader/22/pt-br== Instalando ícones ==
...ecture/KDE3/Icon Loader/23/pt-brÍcones podem vir em diferentes tamanhos e profundidades de exibição.
Vou me referir a esses ícones como ''ícones temáticos''. Ícones que vêm em
apenas uma forma são chamados de ''ícones não temáticos''.
...ecture/KDE3/Icon Loader/24/pt-br=== Padrão dos tamanhos de ícone ===
...ecture/KDE3/Icon Loader/25/pt-brÍcones temáticos vêm em diferentes tamanhos e profundidades de exibição. Os tamanhos normais são os seguintes:
...ecture/KDE3/Icon Loader/26/pt-br;40 Colors
:16x16 pixels
:22x22 pixels
:32x32 pixels
...ecture/KDE3/Icon Loader/27/pt-br;Truecolor
:22x22 pixels
:32x32 pixels
:48x48 pixels
...ecture/KDE3/Icon Loader/28/pt-brPor favor, consulte [http://www.kde-artists.org/introduction.html KDE icon factory]
para informações quais tamanhos de ícones são obrigatórios e mais.
Lembre-se que cada uma destas dimensões pode ser ligada a um grupo de ícones.
...ecture/KDE3/Icon Loader/29/pt-br=== Contexto do ícone ===
...ecture/KDE3/Icon Loader/30/pt-brÍcones temáticos são armazenados em uma hierarquia de diretório de acordo aos seus
'''1. profundidade''', '''2. tamanho''' e '''3. contexto'''. 
O termo ''contexto'' é um novo conceito introduzido pelo esquema de ícone do KDE. 
O contexto de um ícone é o que o ícone ''significa''. Os contextos padrões são apresentados abaixo:
...ecture/KDE3/Icon Loader/31/pt-br* '''action''' - O ícone representa uma ação na barra de ferramentas, por exemplo "Abrir" ou "Salvar".
* '''application''' - O ícone representa um aplicativo, por exemplo "kfind".
* '''device''' - O ícone representa algo relacionado ao dispositivo, por exemplo "floppy" ou "mount".
* '''filesystem''' - O ícone representa algo no sistema de arquivo, por exemplo "directory", "socket" ou "trashcan".
* '''mimetype''' - O ícone representa um mimetype, por exemplo "text/html".
...ecture/KDE3/Icon Loader/32/pt-brOs "contextos" são importantes em um caso: selecionar um ícone. Quando um aplicativo deseja que o usuário selecione um ícone para, digamos, uma barra de ferramentas, seria muito hostil mostrar todos os ícones instalados no KDE. Em vez disso, é muito melhor deixar o usuário selecionar um ícone dos ícones de "ação" apenas. Todos estes representam alguma ação e portanto, são adequados para barras de ferramentas.
...ecture/KDE3/Icon Loader/33/pt-br===  Hierarquia de diretórios  ===
...ecture/KDE3/Icon Loader/34/pt-brA hierarquia dos diretórios na qual ícones temáticos são armazenados segue.
Os nomes dos diretórios são auto-explicativos.
...ecture/KDE3/Icon Loader/35/pt-brhicolor/
     22x22/
         actions/
         apps/
         devices/
         filesystems/
         mimetypes/
     32x32/
         ...
     48x48/
         ...
 
 locolor/
     16x16/
         ...
     22x22/
         ...
     32x32/
         ...
...ecture/KDE3/Icon Loader/36/pt-br=== Diretório raiz ===
...ecture/KDE3/Icon Loader/37/pt-brÍcones temáticos podem ser instalados de forma global com relação ao KDE, ou em um lugar especifico do aplicativo. No caso global, a hierarquia do tema do ícone 
reside em {{path|$KDEDIR/share/icons}} enquanto no caso do aplicativo específico, está em {{path|$KDEDIR/share/apps/$APPNAME/icons}}.
...ecture/KDE3/Icon Loader/38/pt-br=== Instalação de ícones temáticos ===
...ecture/KDE3/Icon Loader/39/pt-brO sistema de configuração fonte do KDE (especificamente, am_edit) tem suporte para
instalação de ícones temáticos. Primeiro, você tem que nomear seus ícones de uma forma que seja claro onde eles devem ser instalados. A convenção de nomenclatura é explicada na tabela que se segue:
...ecture/KDE3/Icon Loader/40/pt-br{|
!|depth
! size
! -
! context
! -
! name
! .png
|-
|| hi || 16 || || action
|-
|| lo || 22 || || app
|-
||    || 32 || || device
|-
||    || 48 || || filesys
|-
||    ||    || || mime
|}
...ecture/KDE3/Icon Loader/41/pt-brExemplos:
...ecture/KDE3/Icon Loader/42/pt-brlo22-action-open.png
 hi48-app-kfind.png
...ecture/KDE3/Icon Loader/43/pt-brPara instalar estes ícones globalmente, adicione essa linha ao seu <tt>Makefile.am</tt>.
...ecture/KDE3/Icon Loader/44/pt-brKDE_ICON = open kfind
...ecture/KDE3/Icon Loader/45/pt-bre para instalá-los num diretório específico de aplicativo, use isso:
...ecture/KDE3/Icon Loader/46/pt-bricondir = $(kde_datadir)/myapp/icons
 icon_ICON = open kfind
...ecture/KDE3/Icon Loader/47/pt-br=== Carregando ícones temáticos ===
Ícones temáticos são carregados com o iconloader, usando os grupos de ícone padrões.
Por exemplo:
...ecture/KDE3/Icon Loader/48/pt-br<syntaxhighlight lang="cpp-qt">
QPixmap pm;
pm = loader->loadIcon("kfind", KIcon::Desktop);
</syntaxhighlight>
...ecture/KDE3/Icon Loader/49/pt-brIsso carregará o ícone "kfind", de profundidade e tamanho especificados pelo grupo ''Desktop''.
...ecture/KDE3/Icon Loader/50/pt-br=== Ícones não temáticos ===
...ecture/KDE3/Icon Loader/51/pt-brÍcones não temáticos são instalados em {{path|$KDEDIR/share/apps/$APPNAME/pics}}. Para instalá-los, use isso em seu <tt>Makefile.am</tt>.
...ecture/KDE3/Icon Loader/52/pt-bricondir = $(kde_datadir)/myapp/pics
 icon_DATA = open kfind
...ecture/KDE3/Icon Loader/53/pt-brVocê não deve dar aos ícones nomes especiais.
Além disso, nenhum outro processamento é feito com eles: sem efeitos e tamanho, seleção de profundidade.
...ecture/KDE3/Icon Loader/54/pt-brÍcones não temáticos podem ser carregados com o iconloader usando o grupo ''User''. Isso carregará um ícone de usuário.
...ecture/KDE3/Icon Loader/55/pt-br<syntaxhighlight lang="cpp-qt">
QPixmap pm;
pm = loader->loadIcon("myicon", KIcon::User);
</syntaxhighlight>
...ecture/KDE3/Icon Loader/56/pt-br== Conclusão ==
Há 3 formas de instalar ícones: temático global, temático de aplicativo especifico
e não temático. Todos os tipos de ícones podem ser carregados com o
iconloader. Você deve escolher uma instalação específica dependendo de suas necessidades.
...ecture/KDE3/Icon Loader/57/pt-br''Autor inicial:'' Geert Jansen [mailto:jansen@kde.org &lt;jansen@kde.org&gt;]
...ecture/KDE3/Icon Loader/58/pt-br[[Category:KDE3]]
[[Category:Architecture]]
NavigationShowing 59 messages.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal