DTPRINTRESETCONNECTION(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

✨ NAME ✨

DtPrintResetConnection — the library call that resets the print display connection managed by a DtPrintSetupBox. yep bestie, this is the DtPrintResetConnection(library call) page, and we're gonna make it make sense 💅

🎀 SYNOPSIS 🎀

       #include &<Print.h>
       XtEnum DtPrintResetConnection(
       Widget wid,
       DtPrintResetConnectionMode mode);

🦋 DESCRIPTION 🦋

okay so DtPrintResetConnection is a convenience function that comes with the DtPrintSetupBox widget. it lets applications tell the widget to stop managing the X print server connection. there's a mode parameter because the widget needs to know whether it should close the print connection by calling XpDestroyPrintContext and XCloseDisplay, or just relinquish control of the connection without closing it. very "you can hold it, but don't touch my stuff" energy 💅

this function is intended for apps that fork a child process to do the print rendering operation. immediately after the fork happens, the parent process closes its X print server connection and keeps its connection to the video X server. the forked child, on the other hand, closes its video X server connection and performs the rendering operation on the X print server connection. teamwork, but make it Unix 🌈

💖 ARGUMENTS 💖

  • wid — the DtPrintSetupBox widget ID. that's the widget bestie in question 🫶
  • mode — tells DtPrintResetConnection whether it should close the X print server connection, or just make the DtPrintSetupBox stop managing the connection. valid values are:
    • DtPRINT_CLOSE_CONNECTION — set by the parent process when the application forks a child to perform the print rendering. this will cause the DtNclosePrintDisplayCallback list set for the passed DtPrintSetupBox to be called. noted, exactly as written 👀
    • DtPRINT_RELEASE_CONNECTION — set when the application wants to destroy the DtPrintSetupBox widget instance and still perform print rendering using the X print server connection that the widget initiated. for example, the child process of an application that forks to perform print rendering will close the video display connection (thereby destroying the DtPrintSetupBox widget) prior to print rendering. no DtPrintSetupBox callbacks will be called as a result of this operation. zero callbacks, periodt 💀

👑 RETURN VALUE 👑

  • DtPRINT_SUCCESS — DtPrintResetConnection was successful. slay ✨
  • DtPRINT_NO_CONNECTION — an open X print server connection is not currently being managed by the DtPrintSetupBox.
  • DtPRINT_BAD_PARM — the value passed for wid is NULL, or an invalid mode was passed. yeah, that's a nope 🙈

🌸 ENVIRONMENT VARIABLES 🌸

None — literally no environment variables in the mix here, bestie.

⭐ RESOURCES ⭐

None — no resources listed on this page.

🧚 ACTIONS/MESSAGES 🧚

None — no actions or messages listed.

💜 ERRORS/WARNINGS 💜

None — no errors or warnings listed.

🍓 EXAMPLES 🍓

None — no examples on this page, sadly.

🎀 FILES 🎀

None — no files listed.

🔥 SEE ALSO 🔥

DtPrintSetupBox(3) — go read that one next, iykyk 💖

cute sign-off: the footer here is just DtPrintResetConnection(library call) — no extra version/date line to spill, so that's the whole outro, mwah 💋✨

📦 where this page comes from