Name: Juce Tutorial 01- The Document Window Class
Uploaded: 2025-03-21T21:49:32.000Z
Duration: 17 min 43 s
Description: Thousands of YouTube videos with English-Chinese subtitles! Now you can learn to understand native speakers, expand your vocabulary, and improve your pronunciation...

Sentences with would like

I'd like to welcome you to your second Guice framework tutorial.

To-infinitive

Today we're going to be going over the document windows class, which is what allows us to create a blank window for our app where we can change its appearance and size.

As I've said before, I'm learning Guice myself, so I'm going to be creating these new tutorials as I learn, and I hope that they're going to help you learn as well.

And because I'm just learning the Guice framework, I'm going to be a little bit more thorough with the way that I'm going through these classes and through these tutorials.

So I'm going to be basically trying to explain everything that I can rather than just throwing in random stuff.

So as I said before, today we're going to be going through the document windows class, and that's going to allow us to create basically a blank slate with maximize and minimize windows and close windows for us to create our application.

This is going to follow closely the Guice application window class tutorial that's on their website, and I'm going to link that below.

There's also a project that I'm going to link below as well that I've downloaded from the Guice website, and this is what I'm going to be following along with, and I would advise you to download that project as well and follow along so you can learn.

So I'm just going to open this project here, which is mainwindowtutorial.juicer.

So we're just going to go through just the steps.

I like to do a lot of repetition to try to get to know the workflow of something new.

So just going through opening the Pro Juicer, and we have our main.cpp file here.

So now we're just going to open it up in Xcode.

Okay, we're on Mac once again, so just going to wait for that to open.

Okay, so I've taken a look at this already and kind of gone through it, so I'm going to explain it to you the best that I can.

This may look like a lot to really take in, but trust me, when you break it down, it's a little bit more simple than it probably looks at first.

So first, we have a class called mainwindowtutorialapplication, which we can see inherits from another class called the Guice application.

This is just really what allows the Guice framework in your app to kind of start and shut down when it needs to shut down.

So it's just, you know, you're kind of overriding functionality.

So these functions here are just kind of your basic functionality for the Guice framework.

Okay, and then if we scroll down a little bit further, we see another class that's inside of this that's called mainwindow, which inherits from what we were discussing before, the document window class.

Okay, so what we're going to do first is we're going to just command click into document window, command click into this class here just so we can take a look and see the documentation on what exactly the document window class is.

Okay, so we're going to click in there, and I should mention that in my readings I've seen that what they say is that when you're creating a class within Guice, what you would normally do is inherit from a Guice class in this type of fashion, and that'll allow you to have the functionality that you need to do whatever you need to do, and then also to create new things as you need to add more scope to your class.

The documentation is really good in Guice, so we can see here that it just says that the document window class is a resizable window that has a title bar, maximize, minimize, and close buttons.

Okay, now if we scroll down just a little bit, we can take a look at the that we have our constructor here that has a set of parameters, so we're just taking a look at what those are about.

Okay, so here we have just an explanation here up above, so we have a name for our window, a background color, and then the required buttons.

Now, I found it really interesting the way that these buttons are set up, and it was something new that I learned, and I thought that I should just take a moment to just kind of go through that for other people that might not know.

So this approach that they are taking to adding certain buttons or taking them away is called a bit mask.

Okay, and I've just kind of typed this down real quick.

So if you know about bitwise operations, this is basically where instead of talking about numbers specifically, you're actually talking about the numbers as they're in binary and using these to actually create functions.

So that might sound a little bit confusing.

Let me see if I can explain a little bit better.

So if we look here, okay, and if we go back to thinking about numbers in binary, okay, if we just look here at this 0001, okay, that's one, that's the number one in binary, right?

So and then if we look at 0010, that's the number two in binary, and then four in binary is 0100.

Okay, so if we just look over here to the left, the way that they've got these title button bars, title bar buttons, rather.

So you can see that the minimize button is would be button one, maximize button would be button two, close button would be four, if you want all the buttons, it would be seven.

Okay, which is a little bit strange, but I find it really interesting.

And so you can see that I shouldn't take too long on this, but I just found it really fascinating.

So you can see here that if it's just the one in the one spot, then it's just minimize, if it's just the one in the two, in the twos spot, then it would be the maximize button, and then just the one in the fours spot, then it would be just the close button.

But if it's all of them, then it's all the buttons.

Okay, so yeah, I just found that interesting.

And I'll link you to a tutorial video on bitmasks.

And yeah, it's the tutorial that I read in juice said that they use that quite often as well.

So something that you probably want to pick up if don't know it already.

So we have the document window constructor, as I said before, okay, so it has a name.

And then if we look, if we go back just above here, to our initialize, okay, so the applications initialization codes, that's what happens when the application first starts.

Okay, so we got main window equals new main window, get application names that so if I compile that right now, okay, and then um, so I'm just gonna compile that quickly here.

Okay, so we can see here that we have a window that's called main window tutorial, which is the same as my app name.

Okay, then we can see that it's it's 300 by 200, it was in the center of the screen when it compiled, and then set visible is the true which just means that it appears on the screen.

Okay, so let's just change a couple things here.

So as I said before, this uses a bit mask to, to create the which buttons appear and which ones disappear.

Okay, so let's just try button number four, right?

Okay, there's a couple different ways that we can do this.

Okay, so we can we can call that two ways, we can either call it by just by just calling the number four.

Okay, so if I go back into documentation again, four is the close button.

So probably a better way of saying it would probably be document window.

So we see that the background color is black.

So once again, we can just Command click into here, just see what options we have in terms of colors.

Okay, so now, what we can do is we can just take a look to see what other functionality that we can get from from this window.

Okay, so the way that I want to do that is by just looking in the juice API itself.

Okay, so if we go here to the juice API, just the documentation.

Okay, so we need to look in the document window class.

I know some of you might be like, oh, this is, you know, can you just go faster, but I really just want to go through this because this is something that was really useful to me and that I really needed to learn just to get into the kind of flow of how how this framework actually works.

So, so we got document window class reference.

Okay, so this tells us all of our all of our functions.

And we can just scroll down here, see what other functionality that we have.

Right, so I've already looked through this didn't really see anything that looked really kind of, you know, that I could demonstrate really easily, but thought it'd be cool just to go down here.

So it also shows here what what other classes that is inheriting.