samp.directory
← Scripts et bibliothèques

renodwi/rdialog-pages

Pas de description sur GitHub.

Bibliothèque★ 1mis à jour mars 2026Pas de licencePawnsampctl
Ouvrir sur GitHub

Ce dépôt n’a pas de fichier de licence. Il est public en lecture, mais cela ne donne pas à lui seul le droit de le réutiliser.

Installer avec sampctl

sampctl package install renodwi/rdialog-pages

Lance ceci dans le dossier de ton projet. sampctl télécharge le paquet et ce dont il dépend.

L’essayer dans le compilateur Pawn →

Ajoute ses fichiers include, avec les bibliothèques dont il dépend, au compilateur Pawn de ton navigateur, prêts à être inclus dans un script.

Dépend de 1 paquet

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

Cette page est construite à partir de ce que GitHub publie sur le dépôt. samp.directory n’héberge pas le code. Signaler un problème avec cette fiche

renodwi/rdialog-pages : Bibliothèque SA-MP | samp.directory