samp.directory
← Skrypty i biblioteki

renodwi/rdialog-pages

Brak opisu na GitHubie.

Biblioteka★ 1zaktualizowano mar 2026Brak licencjiPawnsampctl
Otwórz na GitHubie

To repozytorium nie ma pliku licencji. Jest publiczne do odczytu, ale samo to nie daje pozwolenia na ponowne użycie.

Zainstaluj za pomocą sampctl

sampctl package install renodwi/rdialog-pages

Uruchom to w folderze swojego projektu. sampctl pobiera pakiet i to, od czego zależy.

Wypróbuj w kompilatorze Pawn →

Dodaje jej pliki include, razem z bibliotekami, od których zależy, do kompilatora Pawn w twojej przeglądarce, gotowe do dołączenia w skrypcie.

Zależy od 1 pakietu

README.md

rdialog-pages

Sebuah include sederhana untuk SA-MP yang memungkinkan penggunaan dialog dengan sistem halaman (paginated dialog).
Library ini membantu kamu menampilkan daftar panjang data dalam dialog dengan tombol “Next” dan “Back”, tanpa perlu membuat banyak dialog manual.


Installation

Simply install to your project:

sampctl package install renodwi/rdialog-pages

Include in your code and begin using the library:

#include <rdialog-pages>

Usage

📘 Konsep Utama

Library ini meniru perilaku paginated UI di SA-MP dengan cara menyimpan daftar item dalam array per-player, lalu menampilkannya secara bertahap melalui sistem dialog bawaan (ShowPlayerDialog).

Kamu dapat:

  • Menambahkan item ke daftar dialog.
  • Mengatur jumlah item per halaman.
  • Menambahkan tombol navigasi “Next” dan “Back”.
  • Menangani respons pemain dari halaman tertentu.

⚙️ API Reference

ClearPlayerDialogPages(playerid)

Menghapus seluruh daftar item dialog pemain dan mengatur ulang halaman ke awal.

Parameters:

  • playerid: ID pemain yang datanya akan dihapus.

Returns: 1


AddPlayerDialogPages(playerid, const listitem[])

Menambahkan item baru ke daftar dialog pemain.

Parameters:

  • playerid: ID pemain target.
  • listitem[]: Teks item yang akan ditampilkan pada dialog.

Returns:

  • 1 jika berhasil.
  • 0 jika jumlah item sudah mencapai batas MAX_RDIALOG_PAGES (500).

ShowPlayerDialogPages

Fungsi utama untuk menampilkan dialog dengan sistem halaman.

Parameters:

ShowPlayerDialogPages(playerid, const function[], style, const caption[], const button1[], const button2[], item_per_page = 10, const nextbutton[] = "{FF0000}Halaman Selan>>>", const backbutton[] = "{FF0000}<<< Halaman Sebelumnya");

Deskripsi:

  • function: Nama callback yang akan dipanggil saat pemain memilih item.
  • style: Tipe dialog (mis. DIALOG_STYLE_LIST, DIALOG_STYLE_TABLIST_HEADERS, dll).
  • caption: Judul dialog.
  • button1 dan button2: Label tombol dialog.
  • item_per_page: Jumlah item per halaman (default 10).
  • nextbutton dan backbutton: Label navigasi antar halaman.

🔁 Callback Integrasi

Callback bawaan SA-MP OnDialogResponse di-hook agar sistem rDialogPages bisa bekerja otomatis. Kamu hanya perlu mendefinisikan callback baru dengan nama sesuai argumen function pada ShowPlayerDialogPages.

Contoh:

DialogPages:MyMenu(playerid, response, listitem, inputtext[])
{
    if (!response) return 1;

    switch (listitem)
    {
        case 0: SendClientMessage(playerid, -1, "Kamu memilih item 1");
        case 1: SendClientMessage(playerid, -1, "Kamu memilih item 2");
    }
    return 1;
}

🧩 Contoh Penggunaan Lengkap

#include <a_samp>
#include <rdialog-pages>

public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/testpage", true))
    {
        ClearPlayerDialogPages(playerid);

        AddPlayerDialogPages(playerid, "Item 1");
        AddPlayerDialogPages(playerid, "Item 2");
        AddPlayerDialogPages(playerid, "Item 3");
        AddPlayerDialogPages(playerid, "Item 4");
        AddPlayerDialogPages(playerid, "Item 5");
        AddPlayerDialogPages(playerid, "Item 6");

        ShowPlayerDialogPages(playerid,
            "MyMenu",
            DIALOG_STYLE_LIST,
            "Contoh rDialog Pages",
            "Pilih",
            "Tutup",
            3 // Item per page
        );
        return 1;
    }
    return 0;
}

DialogPages:MyMenu(playerid, response, listitem, inputtext[])
{
    if (!response) return 1;
    new msg[64];
    format(msg, sizeof msg, "Kamu memilih item %d", listitem + 1);
    SendClientMessage(playerid, -1, msg);
    return 1;
}

Testing

Untuk mengetes library ini, jalankan paket dengan perintah berikut:

sampctl package run

Saat dijalankan, gunakan perintah /testpage di dalam game untuk mencoba fitur paged dialog.


Catatan

  • Maksimal item per pemain: 500
  • Panjang string per item: 256
  • Fungsi otomatis menangani \n dan \r agar tampilan dialog tetap rapi.
  • Kompatibel dengan sistem callback eksternal lainnya berkat alias rdlgpgs_OnDialogResponse.

© 2025 – Created by @renodwi

Ta strona jest zbudowana z tego, co GitHub publikuje o repozytorium. samp.directory nie hostuje kodu. Zgłoś problem z tym wpisem

renodwi/rdialog-pages: Biblioteka SA-MP | samp.directory