repo_zf1/documentation/manual/pl/module_specs/Zend_Mime_Part.xml

<sect1 id="zend.mime.part">
    <title>Zend_Mime_Part</title>

    <sect2 id="zend.mime.part.introduction">
      <title>Wprowadzenie</title>

      <para>Ta klasa reprezentuje pojedynczą część wiadomości MIME. Zawiera ona
      aktualną zawartość części wiadomości oraz informacje o jej kodowaniu, typie
      oraz o oryginalej nazwie pliku. Dostarcza ona metody do generowania łańcuchów
      znaków z przechowywanych danych. Obiekty <code>Zend_Mime_Part</code> mogą
      być dodane do
      <link linkend="zend.mime.message"><code>Zend_Mime_Message</code></link>
      aby zebrać kompletną wieloczęściową wiadomość.</para>
    </sect2>

    <sect2 id="zend.mime.part.instantiation">
        <title>Tworzenie instancji</title>

        <para>Obiekt <code>Zend_Mime_Part</code> jest tworzony z łańcuchem znaków
        zawierającym część wiadomości podanym jako parametr konstruktora.
        Domyślny typ to OCTET-STREAM, a kodowanie to 8Bit. Po utworzeniu obiektu
        <code>Zend_Mime_Part</code>, jego podstawowe atrybuty mogą być zmienione
        bezpośrednio:</para>

         <programlisting role="php"><![CDATA[
public $type = ZMime::TYPE_OCTETSTREAM;
public $encoding = ZMime::ENCODING_8BIT;
public $id;
public $disposition;
public $filename;
public $description;
public $charset;
]]>
        </programlisting>
    </sect2>

  <sect2 id="zend.mime.part.methods">
    <title>Metody do renderowania części wiadomości do łańcucha znaków</title>

    <para><code>getContent()</code> zwraca zawartość MimePart zakodowaną
    jako łańcuch znaków przy użyciu kodowania określonego w atrybucie $encoding.
    Poprawne wartości to ZMime::ENCODING_*. Konwersje zestawów znaków nie są
    przeprowadzane.</para>

    <para>
        <code>getHeaders()</code> zwraca nagłówki Mime dla zawartości
        MimePart wygenerowane na podstawie informacji zawartych w publicznie dostępnych
        atrybutach. Przed wywołaniem tej metody, atrybuty obiektu muszą być poprawnie
        zdefiniowane.
        <itemizedlist>
            <listitem>
                <para>
                    <code>$charset</code>
                    musi określać aktualny zestaw znaków zawartości, jeśli jest ona typu
                    tekstowego (Text lub HTML).
                </para>
           </listitem>

           <listitem>
               <para>
                   <code>$id</code>
                   może być ustawiony aby identyfikować obrazy wstawione bezpośrfednio
                   w kodzie wiadomości HTML.
               </para>
           </listitem>
           <listitem>
               <para>
                   <code>$filename</code>
                   zawiera nazwę pliku która będzie mu nadana gdy będzie on ściągany.
               </para>
           </listitem>
           <listitem>
               <para>
                   <code>$disposition</code>
                   określa czy plik powinien być traktowany jako załącznik, czy powinien być
                   użyty bezpośrednio w wiadomości HTML.
               </para>
           </listitem>
           <listitem>
               <para>
                   <code>$description</code>
                   jest używane jedynie dla celów informacyjnych.
               </para>
           </listitem>
      </itemizedlist>
    </para>
  </sect2>
</sect1>