Klasa "Text": przyciski, pola tekstowe, etykiety - Revision history

Krashan: Sections spacing restored.

2011-01-29T17:54:43Z

Sections spacing restored.

Krashan: /* Przyciski */ Translated.

2011-01-29T17:54:06Z

‎Przyciski: Translated.

Krashan: Translation in progress.

2011-01-29T17:36:38Z

Translation in progress.

Krashan: Translation in progress.

2011-01-29T17:09:43Z

Translation in progress.

Krashan: /* Przyciski */ Translation in progress.

2011-01-29T16:36:10Z

‎Przyciski: Translation in progress.

Krashan: /* Pola tekstowe */ Translated.

2011-01-29T16:22:57Z

‎Pola tekstowe: Translated.

Krashan: /* Etykiety */ Translated.

2011-01-29T16:18:11Z

‎Etykiety: Translated.

Krashan: /* Najważniejsze atrybuty */ Translated.

2011-01-29T15:48:21Z

‎Najważniejsze atrybuty: Translated.

Krashan: /* Wprowadzenie */ Translated.

2011-01-29T15:38:58Z

‎Wprowadzenie: Translated.

Krashan: Translated sections titles.

2011-01-29T15:13:03Z

Translated sections titles.

@@ Line 7: / Line 7: @@
 Klasa ''Text'' używa [[MUI Text Rendering Engine|procedur tekstowych MUI]] do kreślenia tekstu. Procedury te obsługują tekst wieloliniowy, style tekstu (pogrubienie, kursywa), kolory, oraz grafikę w tekście. Z możliwości tych powinno się korzystać oszczędnie, aby wygląd interfejsu był spójny z systemem, a jego używanie przyjemne. Efekty tekstowe kontroluje się wstawiając sekwencje kontrolne do tekstu. Jeszcze jedną cechą procedur tekstowych MUI jest możliwość wyrównywania tekstu w obszarze obiektu (do lewej, do prawej, wyśrodkowanie).
 ==Najważniejsze atrybuty==
@@ Line 15: / Line 16: @@
 Dodatkowe informacje o klasie ''Text'' można znaleźć w dokumentacji dołączonej do SDK.
 ==Etykiety==
@@ Line 29: / Line 31: @@
 Etykieta tekstowa może mieć podkreślony jeden znak, określony przez atrybut ''MUIA_Text_HiChar''. Podkreślenia tego używamy jako wizualnej podpowiedzi skrótu klawiszowego dla podpisywanego gadżetu, wtedy, gdy gadżet taki skrót posiada. Rzecz jasna podkreślamy znak skrótu. Więcej na ten temat w podrozdziale [[#Przyciski|Przyciski]] poniżej.
 ==Pola tekstowe==
@@ Line 35: / Line 38: @@
   MUIA_Frame,             MUIV_Frame_Text,
   MUIA_Background,        MUII_TextBack,
 ==Przyciski==

@@ Line 65: / Line 65: @@
-Another keyboard handling feature provided by MUI is hotkeys. A hotkey just activates a button associated to it. Hotkeys have the following features:
+Drugą możliwością obsługi przycisków z klawiatury są skróty klawiszowe (ang. ''hotkeys''). Skrót aktywuje przycisk mu przypisany. Skróty mają następujące cechy:
-*MUI provides a visual hint of a button hotkey by underlining the hotkey letter in the button label. It implies that the hotkey letter must exist in the label.
+*MUI (poprzez atrybuty) daje możliwość graficznej podpowiedzi istnienia skrótu klawiszowego, przez podkreślenie litery skrótu w tekście przycisku. Oznacza to, że litera skrótu powinna być jedną (np. pierwszą) z liter napisu na przycisku.
-*There is visual feedback for using a hotkey, the button is pressed as if it has been clicked with the mouse.
+*W momencie użycia skrótu klawiszowego, przycisk również "wciska się" graficznie, tak samo jakby był kliknięty przyciskiem myszy.
-Not every button in a GUI has to have a hotkey. The best practice is to assign hotkeys only for the most used buttons, especially if there are many buttons in a window. A hotkey is defined with two attributes:
+Nie każdy przycisk tekstowy musi mieć skrót klawiszowy. Najlepiej przypisywać skróty jedynie najczęściej używanym przyciskom, zwłaszcza, gdy przycisków w oknie jest dużo. Skrót klawiszowy definiuje się używając dwóch atrybutów:
-*'''''MUIA_Text_HiChar''''' &ndash; this attribute specifies a letter to be underlined in the label. It is case insensitive.
+*'''''MUIA_Text_HiChar''''' &ndash; określa która litera powinna być podkreślona w napisie na przycisku. Ten atrybut ignoruje wielkość liter.
-*'''''MUIA_ControlChar''''' &ndash; this attribute specifies a hotkey. Of course it should be the same as the above one. It should be a lowercase letter, as uppercase forces a user to press SHIFT, making the hotkey less comfortable to use. There is also no visual hint for SHIFT requirement. Digits may be also used as hotkeys if the label contains them. Using punctuation and other characters should be avoided. An example of use:
+*'''''MUIA_ControlChar''''' &ndash; określa sam skrót klawiszowy. Oczywiście powinna to być ta sama litera co w poprzednim atrybucie. Powinna to być mała litera, inaczej użytkownik będzie musiał wciskać klawisz z SHIFT-em, co jest niewygodne. W dodatku nie ma żadnej wizualnej wskazówki co do tego, że wymagane jest wciśnięcie SHIFT-a. Jako skrótów klawiszowych można używać również cyfr, jeżeli znajdują się w napisach na przyciskach. Używanie znaków interpunkcyjnych i innych niealfanumerycznych jest zdecydowanie niezalecane. Oto przykład zdefiniowania skrótu klawiszowego:
   MUIA_Text_Contents,     "Destroy All",
@@ Line 76: / Line 76: @@
   MUIA_Text_ControlChar,  'a'
-Note that these attributes take a single char, not a string.
+Co ważne, wartościami obu atrybutów są pojedyncze znaki, a nie łańcuchy tekstowe o długości 1.

@@ Line 59: / Line 59: @@
   MUIA_CycleChain,        TRUE,
-Any gadget entered into the chain may be selected by pressing the TAB key (for default MUI keyboard settings). The selected object has a special frame drawn around it. Then it may be activated by some key set in MUI preferences. For buttons the default "pressing" key is the return key. A rule of thumb for cycle chaining:
+Każdy gadżet umieszczony w łańcuchu może być wybrany klawiszem TAB (przy standardowych ustawieniach MUI). Wybrany obiekt ma dookoła dodatkową ramkę. Można go uaktywnić używając klawisza ustawionego w preferencjach użytkownika. Dla przycisków domyślnym klawiszem jest ENTER. Główna zasada umieszczania obiektów w łańcuchu klawisza TAB jest następująca:
-<big><center>'''Every''' gadget accepting user input '''must''' be added to the TAB cycle chain.</center></big>
+<big><center>'''Każdy''' obiekt reagujący na akcje użytkownika '''musi''' być dodany do łańcucha.</center></big>

@@ Line 50: / Line 50: @@
   MUIA_Text_PreParse,     "\33c",
-After definition of the button appearance it is time to handle user input. The button behaviour is defined by the ''MUIA_InputMode'' attribute with three values:
+Po zdefiniowaniu wyglądu przycisku pora na określenie zachowania przy akcji użytkownika. Zachowanie przycisku określa atrybut ''MUIA_InputMode'' z trzema możliwymi wartościami:
-*'''''MUIV_InputMode_None''''' &ndash; The default value, button does not react on anything.
+*'''''MUIV_InputMode_None''''' &ndash; Wartość domyślna. Przycisk nie reaguje na mysz i klawiaturę.
-*'''''MUIV_InputMode_RelVerify''''' &ndash; A simple pushbutton activated by a left mouse button click.
+*'''''MUIV_InputMode_RelVerify''''' &ndash; Przycisk jednostanowy, reagujący na lewy przycisk myszy, powracający do stanu nieaktywnego.
-*'''''MUIV_InputMode_Toggle''''' &ndash; A two-state button, one click switches it on, another one switches it off.
+*'''''MUIV_InputMode_Toggle''''' &ndash; Przycisk dwustanowy, jedno kliknięcie wciska go, następne zwalnia.
-Another common bug with MUI buttons is to omit keyboard handling. The mouse is not everything. The first, obligatory step is to enter the button into the window's TAB key cycle chain:
+Kolejny częsty błąd popełniany przez programistów, to zignorowanie obsługi obiektów GUI z klawiatury. Myszka to nie wszystko. Pierwszy, obowiązkowy krok to dodanie przycisku do łańcucha obiektów okna po których można "krążyć" klawiszem TAB:
   MUIA_CycleChain,        TRUE,

@@ Line 37: / Line 37: @@
 ==Przyciski==
-A text button is an instance of the ''Text'' class too. It has more attributes than a plain label however, because it handles user input. MUI has a predefined background and frame for buttons:
+Przycisk tekstowy to również obiekt klasy ''Text''. Ma jednak więcej atrybutów, ponieważ reaguje na akcje użytkownika. MUI posiada definiowane przez użytkownika tło i ramkę dla przycisków:
   MUIA_Frame,             MUIV_Frame_Button,
   MUIA_Background,        MUII_ButtonBack,
-These attributes also specify a frame and background for the "pressed" state. MUI also has separate font settings for buttons. Forgetting the ''MUIA_Font'' attribute for buttons is one of most common errors in MUI design.
+Atrybuty te określają również tło i ramkę dla "wciśniętego" stanu przycisku. W ustawieniach MUI mamy również odrębną czcionkę dla przycisku. Pominięcie atrybutu ''MUIA_Font'' w przycisku jest niestety jednym z najczęstszych błędów przy tworzeniu interfejsu graficznego.
   MUIA_Font,              MUIV_Font_Button,
-Many users (and programmers) just have the default font defined for buttons, so the bug is not visible. It is recommended to always test a GUI with some unusual font settings for buttons, so the problem is easily visible. Button text is usually centered, which may be done either by inserting the "\33c" sequence at the start of the button label, or using ''MUIA_Text_PreParse''.
+Wielu użytkowników (i programistów) ma po prostu ustawioną główną czcionkę MUI również dla przycisków, więc błąd nie jest widoczny. Autor programu powinien '''zawsze''' przetestować wygląd programu z nietypowymi ustawieniami czcionek, co pozwala na proste uniknięcie takich omyłek. Tekst przycisku jest zazwyczaj wycentrowany, co można osiągnąć poprzedzając tekst sekwencją formatującą "\33c" albo używając tej sekwencji jako wartości atrybutu ''MUIA_Text_PreParse''.
   MUIA_Text_PreParse,     "\33c",

@@ Line 17: / Line 17: @@
 ==Etykiety==
-Labels are the simplest form of ''Text'' instances. They have no frame and inherit their background from the parent object (neither ''MUIA_Frame'' nor ''MUIA_Background'' is specified). They use the standard MUI font in most cases, so ''MUIA_Font'' does not need to be specified either. An important (and often forgotten) detail is a proper text baseline align when a label is used with some framed gadget also containing text (a ''String'' gadget for example). The default MUI behaviour for vertical text positioning is to center it. If the framed gadget uses uneven vertical padding, baselines of the label and the gadget may be unaligned. A special attribute ''MUIA_FramePhantomHoriz'' solves this problem. It is specified for a label with a ''TRUE'' value. The label also has ''MUIA_Frame'' specified with the same frame type as the gadget. Then the label gets an invisible frame of this type (frame horizontal parts to be exact, hence the attribute name) and the text is laid out accordingly. As a result the label and the gadget text are always aligned vertically, assuming they use the same font.
+Etykiety to najprostsze obiekty klasy ''Text''. Nie mają ramki i dziedziczą tło po obiekcie nadrzędnym (nie podaje się ani atrubutu ''MUIA_Frame'', ani ''MUIA_Background''). W większości przypadków używa się głównej czcionki MUI, więc atrybut ''MUIA_Font'' można również pominąć. Ważnym (i niestety często ignorowanym) szczegółem jest wyrównanie linii bazowej tekstu etykiety z linią bazową tekstu w gadżecie (na przykład klasy ''String''), dla którego jest ona podpisem. Domyślnym zachowaniem się MUI przy pionowym pozycjonowaniu tekstu jest jego wyśrodkowanie. Jeżeli podpisywany gadżet używa niesymetrycznych marginesów wewnątrz swojej ramki, linie bazowe tekstu etykiety i tekstu gadżetu mogą być niewyrównane. Specjalny atrybut ''MUIA_FramePhantomHoriz'' pozwala rozwiązać ten problem. Podajemy go etykiecie z wartością ''TRUE''. Oprócz tego podajemy etykiecie atrybut ''MUIA_Frame'' z typem ramki takim samym jak w podpisywanym gadżecie. Wtedy etykieta otrzymuje niewidzialną ramkę tego typu (dokładniej &ndash; niewidzialne poziome części ramki, stąd nazwa atrybutu) i tekst jest rozmieszczany z uwzględnieniem tej ramki. W rezultacie linie bazowe tekstu obu obiektów są zawsze wyrównane o ile tylko obiekty używają tej samej czcionki.
@@ Line 23: / Line 23: @@
-The magnified screenshot above illustrates the label align problem. The string gadget uses uneven padding (top padding is 2 pixels, bottom padding is 0 pixels), which causes the text baseline to misalign by 1 pixel shown on the left. The label on the right has been defined with two additional tags:
+Powiększony fragment zrzutu ekranu powyżej obrazuje problem. Gadżet typu ''String'' ma ustawione nierówne pionowe marginesy wewnętrzne (margines górny na 2 piksele, dolny na 0), co powoduje rozjechanie się linii bazowych tekstów o 1 piksel (po lewej). Etykieta po prawej ma dodane dwa następujące atrybuty:
   MUIA_FramePhantomHoriz,  TRUE,
   MUIA_Frame,              MUIV_Frame_String,
-A label can have one character underlined with the ''MUIA_Text_HiChar'' attribute. It is used to create a visual hint for a hotkey of a labeled gadget. See [[#Buttons|Buttons]] section below for details.
+Etykieta tekstowa może mieć podkreślony jeden znak, określony przez atrybut ''MUIA_Text_HiChar''. Podkreślenia tego używamy jako wizualnej podpowiedzi skrótu klawiszowego dla podpisywanego gadżetu, wtedy, gdy gadżet taki skrót posiada. Rzecz jasna podkreślamy znak skrótu. Więcej na ten temat w podrozdziale [[#Przyciski|Przyciski]] poniżej.
 ==Pola tekstowe==

@@ Line 9: / Line 9: @@
 ==Najważniejsze atrybuty==
-*'''''MUIA_Background''''' and '''''MUIA_Frame''''' are attributes inherited from the ''Area'' class. They specify a background and frame used for an object.
+*'''''MUIA_Background''''' i '''''MUIA_Frame''''' są atrybutami dziedziczonymi z klasy ''Area''. Określają tło i ramkę obiektu.
-*'''''MUIA_Text_Contents''''' specifies the text. It may contain formatting engine escape sequences. The text is buffered internally, so the value of this attribute may point to a local variable or a dynamically allocated buffer.
+*'''''MUIA_Text_Contents''''' określa tekst. Tekst może zawierać sekwencje sterujące formatujące go. Ponieważ tekst jest wewnętrznie buforowany, wartość tego atrubutu może wskazywać na zmienną lokalną, albo pamięć przydzieloną dynamicznie.
-*'''''MUIA_Text_PreParse''''' may be considered a fixed prefix, which is always added at the start of text before rendering. It is usually used for applying constant styles and formatting, for example setting it to "\33c" will always center the text. This attribute simplifies text handling when the text displayed is not constant (for example is loaded from a locale catalog).
+*'''''MUIA_Text_PreParse''''' można traktować jako stały przedrostek dodawany zawsze na początku tekstu przed jego rysowaniem na ekranie. Najczęściej przedrostek ten zawiera sekwencje formatujące. Na przykład wartość tego atrybutu ustawiona na "\33c" spowoduje wycentrowanie tekstu w obiekcie. Atrybut ten upraszcza pracę z tekstem jeżeli tekst wyświetlany w obiekcie nie jest stały (na przykład jest ładowany z katalogu wersji językowej).
-*'''''MUIA_Font''''' is another attribute inherited from the ''Area'' class and specifies a font to be used for text rendering. In most cases it is one of the fonts predefined by the user in MUI settings.
+*'''''MUIA_Font''''' to jeszcze jeden atrybut dziedziczony z klasy ''Area'' i określa czcionkę, jaka zostanie użyta do rysowania tekstu. Najczęściej jest to jedna z czcionek wybranych przez użytkownika w ustawieniach MUI.
 ==Etykiety==

@@ Line 4: / Line 4: @@
 ==Wprowadzenie==
-The ''Text'' class is the most commonly used one for creating gadgets. This is because it not only creates plain labels (also called "static text" in other GUI engines), but also framed read-only text gadgets and textual buttons. In fact MUI has no special class for buttons, a button is just a ''Text'' object with a proper frame and background and user input activated. This versatility can have the disadvantage of allowing for creation of style guide nonconforming interfaces.
+Klasa ''Text'' jest chyba najczęściej używaną klasą do tworzenia elementów GUI. Dzieje się tak dlatego, że obiekty tej klasy to nie tylko zwykłe etykiety (zwane także "tekstem statycznym" w innych bibliotekach GUI), ale również obramowane pola tekstowe tylko do odczytu, jak i przyciski tekstowe. W istocie, MUI nie ma żadnej specjalnej klasy do przycisków, przycisk to po prostu obiekt klasy ''Text'' z odpowiednią ramką, tłem i włączonym reagowaniem na kliknięcie przyciskiem myszy. Ta uniwersalność może być jednak wadą, gdyż pozwala na tworzenie elementów interfejsu nie odpowiadających przyjętym zasadom.
 ==Najważniejsze atrybuty==

@@ Line 1: / Line 1: @@
 ''Grzegorz Kraszewski''
 ----
-<small>Ten artykuł w innych językach: [[Klasa "Text": przyciski, pola tekstowe, etykiety|Polish]]</small>
+<small>Ten artykuł w innych językach: [[Text Class: Buttons, Textfields, Labels|angielski]]</small>
-==Introduction==
+==Wprowadzenie==
 The ''Text'' class is the most commonly used one for creating gadgets. This is because it not only creates plain labels (also called "static text" in other GUI engines), but also framed read-only text gadgets and textual buttons. In fact MUI has no special class for buttons, a button is just a ''Text'' object with a proper frame and background and user input activated. This versatility can have the disadvantage of allowing for creation of style guide nonconforming interfaces.
@@ Line 9: / Line 9: @@
-==Common Attributes==
+==Najważniejsze atrybuty==
 *'''''MUIA_Background''''' and '''''MUIA_Frame''''' are attributes inherited from the ''Area'' class. They specify a background and frame used for an object.
 *'''''MUIA_Text_Contents''''' specifies the text. It may contain formatting engine escape sequences. The text is buffered internally, so the value of this attribute may point to a local variable or a dynamically allocated buffer.
@@ Line 18: / Line 18: @@
-==Labels==
+==Etykiety==
 Labels are the simplest form of ''Text'' instances. They have no frame and inherit their background from the parent object (neither ''MUIA_Frame'' nor ''MUIA_Background'' is specified). They use the standard MUI font in most cases, so ''MUIA_Font'' does not need to be specified either. An important (and often forgotten) detail is a proper text baseline align when a label is used with some framed gadget also containing text (a ''String'' gadget for example). The default MUI behaviour for vertical text positioning is to center it. If the framed gadget uses uneven vertical padding, baselines of the label and the gadget may be unaligned. A special attribute ''MUIA_FramePhantomHoriz'' solves this problem. It is specified for a label with a ''TRUE'' value. The label also has ''MUIA_Frame'' specified with the same frame type as the gadget. Then the label gets an invisible frame of this type (frame horizontal parts to be exact, hence the attribute name) and the text is laid out accordingly. As a result the label and the gadget text are always aligned vertically, assuming they use the same font.
@@ Line 33: / Line 33: @@
-==Textfields==
+==Pola tekstowe==
 A textfield is a read-only framed area showing some (usually changing at runtime) text. The difference between a label and a textfield is that the latter has a frame and a background specified:
@@ Line 40: / Line 40: @@
-==Buttons==
+==Przyciski==
 A text button is an instance of the ''Text'' class too. It has more attributes than a plain label however, because it handles user input. MUI has a predefined background and frame for buttons: